Tripo: 3D Generation

Tripo нысанның жазбаша сипаттамасынан 3D модель материалын жасайды. Өндірушінің кеңірек процестері геометрияны, текстуралауды және кейінгі модель өңдеуді ажыратады; дайын торды бірнеше бұрыштан тексеріп, қажетті көрініске немесе редакторға арналған нақты файлдарды сақтаңыз.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Tripo сипаттамадан немесе көрнекі референстен 3D модель материалдарын жасайды. Оның процестері нысан жасауды текстуралау, қаңқа орнату және түрлендіру сияқты кейінгі қадамдардан ажыратады. Алдымен қажетті материалды және оны жасайтын операцияны анықтаңыз: көрініске арналған статикалық тор, рендерингке арналған текстуралы нысан немесе 3D редакторда әрі қарай дайындалатын модель.

Мәтіннен модель жасау тапсырмасында нысанның пішінін және маңызды бөліктерін сипаттаңыз. Шағын шамды денесі, тұтқасы, саңылаулары және пропорциялары арқылы, ал тіршілік иесін сұлбасы, аяқ-қолдары және қалпы арқылы белгілеуге болады. Нәтижеге маңызды болса, материалын немесе көрнекі стилін атаңыз. Жасалған геометрияны анық жобаға салыстырып бағалау үшін сипаттаманы нысанның өзіне бағыттаңыз.

Өндірушінің референске негізделген процесі үшін нысанның сыртқы пішіні мен айрықша белгілерін көрсететін суреттер дайындаңыз. Бірнеше көрініс пропорциялары мен керек-жарақтары бірізді бір нысанды сипаттауы тиіс. Жасағаннан кейін референсте жасырылған бөліктерді тексеріңіз, себебі сенімді алдыңғы көрініс артқы, астыңғы бөліктің немесе компонент байланыстарының көзделген жобаға сай екенін дәлелдемейді.

Таңдалған модель нұсқасын сұраумен бірге сақтаңыз. Tripo генерация интерфейсі операцияны модель нұсқасы баптауынан бөлек анықтайды, ал құжатталған мәтіннен модель жасау мысалы нақты нұсқаны таңдайды. Материалдарды салыстырғанда нысан сипаттамасының өзгерісін генерация баптауының өзгерісімен шатастырмас үшін нақты нұсқа мен басқару параметрлерін сақтаңыз.

Геометрия мен бет көрінісі — бөлек өндірістік шешімдер. Өндірушінің негізгі процесі текстурасыз модельді текстуралары және физикаға негізделген рендеринг материалдары бар шығыстан ажыратады. Келесі қадамға қажет материал түрін таңдап, торды да, ілеспе материал файлдарын да тексеріңіз. Алдын ала қарау суреті бағдарлануға пайдалы, ал көріністі жинау мен әрі қарай өңдеуге қажетті материал — нақты модельдің өзі.

Дайын нысанды бірнеше бұрыштан қараңыз. Сұлбасын, бөліктерінің бөлінуін, жіңішке белгілерін, саңылауларын және компоненттер түйісетін беттерін тексеріңіз. Стильденген реквизитте пропорцияларды жобалау тапсырмасымен салыстырыңыз. Тауарға ұқсас нысанда қай бөлшектің геометриямен, ал қайсысының тек бет көрінісімен берілгенін тексеріңіз. Нұсқауды немесе референсті өзгертпей тұрып түзету қажет белгіні анықтаңыз.

Генерация асинхронды тапсырма ретінде жүреді. Күйді тексеру кезінде бастапқы тапсырма идентификаторын сақтап, дайын модельді, алдын ала қарауды және басқа қайтарылған файлдарды бірге ұстаңыз. Құжатталған нәтиже модельге қатысты шығыс өрістерін және рендерленген суреттерді қамтиды. Уақытша нәтиже сілтемесіне сенбей және алдын ала қарауды толық 3D нәтиже деп санамай, келесі өндіріс қадамына файлдардың өзін сақтаңыз.

Модельді қажетті редакторға немесе көру ортасына импорттап, бағытын, масштабын, материалдарын және геометриясын сол жерде тексеріңіз. Көрініс реквизиті, жақыннан рендер және анимацияға дайын кейіпкер әртүрлі аяқтау жұмыстарын қажет етеді. Өңдеуге жұмыс көшірмесін қалдырып, жасалған бастапқы материалды тапсырмасы және референстерімен бірге сақтаңыз. Текстура жұмысы немесе қаңқа орнату сияқты басқа операция қажет болса, оны саналы таңдап, шыққан материалды бөлек кезең ретінде тексеріңіз.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

tripo3d

Tripo /tripo3d

Бастау

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: model_3d · Суреттер

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · 3D POST /v1/3d/generations

Кіріс: text
Шығыс: model_3d, image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер tripo3d Шарттар: Ailoot моделін таңдау өрісін пайдаланыңыз.	Әдепкі—
Өріс`type`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Шарттар: Толық мысалда text_to_model қолданылады; басқа тапсырма түрлері құжатталған, сол тапсырмаға тән кірістерді талап етеді.	Әдепкі—
Өріс`model_version`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Шарттар: Құжаттамада нақты көрсетілген нұсқаны таңдаңыз; бұл мысалда v3.0-20250812 қолданылады.	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Жасалатын объектіні сипаттаңыз.	Әдепкі—

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, type, model_version, prompt
Параметр`optional`	Параметр талаптары
Параметр`material_types`	Параметр талаптарыtext
Параметр`conditions`	Параметр талаптарыAiloot моделін таңдау өрісін пайдаланыңыз., Толық мысалда text_to_model қолданылады; басқа тапсырма түрлері құжатталған, сол тапсырмаға тән кірістерді талап етеді., Құжаттамада нақты көрсетілген нұсқаны таңдаңыз; бұл мысалда v3.0-20250812 қолданылады., Жасалатын объектіні сипаттаңыз.

Өмірлік цикл: submit_once_poll_original

GET /v1/3d/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $1.35 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · 3D

curl · бір рет құрып, қабылдау жазбасын сақтаңызБастапқы тапсырманы оқыңызӨзіңізге тиесілі толық дайын болған әрбір ресурсты сақтаңыз

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "tripo3d",
  "type": "text_to_model",
  "prompt": "a cute pig",
  "model_version": "v3.0-20250812"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/3d/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Нәтижелерді алу және сақтау

Ailoot Ultra · 3D

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Барлық дайын нәтижені сақтау

Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.

Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.

Бастапқы жауапты тексеру қажет болса

Қайтарылған ашық тапсырма не операция id мәнін және барлық тақырыптарды сақтаңыз. Тек бастапқы тапсырманы оқыңыз; unknown немесе result_pending_check күйі қайта жасауға рұқсат бермейді.

Жауап өрістері

Өріс	Түрі
Өріс`id`	Түріstring
Өріс`polling_url`	Түріstring
Өріс`provider_task_id`	Түріstring
Өріс`code`	Түріinteger
Өріс`data.task_id`	Түріstring
Өріс`data.status`	Түріstring
Өріс`data.progress`	Түріinteger
Өріс`data.output.*`	Түріstring
Өріс`data.result.*.url`	Түріstring
Өріс`data.result.*.type`	Түріstring
Өріс`data.thumbnail`	Түріstring

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra tripo3d

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

tripo3d

FAQ · Tripo: 3D Generation

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Сұрау қандай өрістерді пайдаланады?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation