Tripo: 3D Generation
Tripo obyekt haqidagi yozma topshiriqdan 3D model artefaktini yaratadi. Ishlab chiqaruvchining kengroq jarayonlari geometriya, teksturalash va modelni keyin qayta ishlashni ajratadi; tayyor poligonal to‘rni bir nechta tomondan tekshiring va maqsadli sahna yoki muharrir uchun haqiqiy fayllarni saqlang.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Tripo tavsif yoki vizual namunadan 3D model artefaktlarini yaratadi. Uning jarayonlari obyekt yaratishni keyingi teksturalash, skelet bilan jihozlash va formatini o‘zgartirish kabi bosqichlardan ajratadi. Avval kerakli artefakt va uni yaratadigan operatsiyani belgilang: sahna uchun statik poligonal to‘r, renderlash uchun teksturali obyekt yoki 3D muharririda keyin tayyorlanadigan model.
Matndan model yaratish topshirig‘ida obyektning shakli va muhim qismlarini tavsiflang. Kichik fonarni tanasi, tutqichi, ochiq joylari va nisbatlari orqali, mavjudotni esa silueti, oyoq-qo‘llari va pozasi orqali belgilash mumkin. Natija uchun muhim bo‘lsa, material yoki vizual ishlov usulini ayting. Yaratilgan geometriyani aniq dizayn bilan solishtirib baholash mumkin bo‘lishi uchun tavsifni obyektning o‘ziga qarating.
Ishlab chiqaruvchining namunaga asoslangan jarayoni uchun obyekt konturi va ajralib turadigan xususiyatlarini ko‘rsatadigan tasvirlarni tayyorlang. Bir nechta rakurs bir xil obyektni izchil nisbatlar va aksessuarlar bilan ko‘rsatishi kerak. Yaratilgandan keyin namunada yashirin qolgan qismlarni tekshiring, chunki ishonarli old ko‘rinish orqa, ostki tomon yoki qismlar o‘rtasidagi ulanishlar kerakli dizaynga mosligini isbotlamaydi.
Tanlangan model versiyasini so‘rov bilan birga saqlang. Tripo’ning yaratish interfeysi operatsiyani model versiyasi sozlamasidan alohida belgilaydi, hujjatlashtirilgan matndan model yaratish misoli esa muayyan versiyani tanlaydi. Obyekt tavsifi o‘zgarishini yaratish konfiguratsiyasi o‘zgarishi bilan adashtirmaslik uchun artefaktlarni solishtirishda aniq versiya va boshqaruv sozlamalarini saqlang.
Geometriya va sirt ko‘rinishi alohida ishlab chiqarish qarorlaridir. Ishlab chiqaruvchining asosiy jarayoni teksturasiz modelni teksturalar va fizikaga asoslangan renderlash materiallari bor chiqishdan ajratadi. Keyingi bosqichga kerakli artefakt ko‘rinishini tanlang, so‘ng poligonal to‘rni ham, unga tegishli material fayllarini ham tekshiring. Oldindan ko‘rish tasviri yo‘nalish olish uchun foydali, sahnani yig‘ish va keyingi tahrir uchun kerakli artefakt esa modelning o‘zi.
Tayyor obyektni bir nechta burchakdan tekshiring. Siluet, qismlarning ajralishi, ingichka elementlar, ochiq joylar va komponentlar tutashgan sirtlarga qarang. Uslublashtirilgan rekvizit uchun nisbatlarni dizayn topshirig‘i bilan solishtiring. Mahsulotga o‘xshash obyekt uchun qaysi detallar geometriyada, qaysilari esa faqat sirt ishlovida ko‘rsatilganini tekshiring. Prompt yoki namunani o‘zgartirishdan oldin tuzatish kerak bo‘lgan xususiyatni aniqlang.
Yaratish asinxron vazifa sifatida bajariladi. Holatni tekshirish davomida asl vazifa identifikatorini saqlang va tayyor model, oldindan ko‘rish tasviri hamda boshqa qaytarilgan fayllarni birga tuting. Hujjatlashtirilgan natija modelga tegishli chiqish maydonlari va renderlangan tasvirlarni o‘z ichiga oladi. Vaqtinchalik natija havolasiga tayanish yoki oldindan ko‘rish tasvirini to‘liq 3D natija deb hisoblash o‘rniga keyingi ishlab chiqarish bosqichi uchun fayllarning o‘zini saqlang.
Modelni maqsadli muharrir yoki ko‘rish muhitiga import qilib, yo‘nalishi, masshtabi, materiallari va geometriyasini shu yerda tekshiring. Sahna rekviziti, yaqin rakursdagi render va animatsiyaga tayyor personaj turli yakuniy ishlovga muhtoj. Tahrir uchun ish nusxasini saqlang, yaratilgan asl artefaktni esa topshirig‘i va namunalari bilan birga asrang. Tekstura yoki skelet bilan ishlash kabi boshqa operatsiya kerak bo‘lsa, uni maqsadli tanlang va natijaviy artefaktni alohida bosqich sifatida tekshiring.
Ailoot Ultra · 3D POST /v1/3d/generations tripo3d
tripo3dBoshlash
Tripo obyekt haqidagi yozma topshiriqdan 3D model artefaktini yaratadi. Ishlab chiqaruvchining kengroq jarayonlari geometriya, teksturalash va modelni keyin qayta ishlashni ajratadi; tayyor poligonal to‘rni bir nechta tomondan tekshiring va maqsadli sahna yoki muharrir uchun haqiqiy fayllarni saqlang.
- Qabul qilinadigan kirish ma’lumotlari
- Matn
- Natijalar
- model_3d · Rasmlar
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot Ultra · 3D POST /v1/3d/generations
- Kirish
text- Chiqish
model_3d,image
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar tripo3d Shartlar: Ailoot model tanlagichidan foydalaning. | Standart— |
Maydontype | Turstring | TalabMajburiy | Qiymatlar va cheklovlar text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Shartlar: To‘liq misolda text_to_model ishlatilgan; boshqa vazifa turlari uchun hujjatdagi vazifaga xos kirishlar kerak. | Standart— |
Maydonmodel_version | Turstring | TalabMajburiy | Qiymatlar va cheklovlar v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Shartlar: Hujjatda aniq ko‘rsatilgan versiyani tanlang; bu misolda v3.0-20250812 ishlatilgan. | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Shartlar: Yaratiladigan obyektni tasvirlang. | Standart— |
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, type, model_version, prompt |
Parametroptional | Parametr talablari |
Parametrmaterial_types | Parametr talablaritext |
Parametrconditions | Parametr talablariAiloot model tanlagichidan foydalaning., To‘liq misolda text_to_model ishlatilgan; boshqa vazifa turlari uchun hujjatdagi vazifaga xos kirishlar kerak., Hujjatda aniq ko‘rsatilgan versiyani tanlang; bu misolda v3.0-20250812 ishlatilgan., Yaratiladigan obyektni tasvirlang. |
Hayot sikli: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariflar
Yakuniy to‘lov qanday hisoblanadi
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
- Tezkor rejim
- Ko‘rsatilmagan Tezkor rejim tanlanganda
- Flex rejimi
- Ko‘rsatilmagan flex rejimi tanlanganda
- Maksimal fikrlash darajasi
- Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda
Taqqoslash uchun taxminiy tariflar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | To‘lov |
|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $1.35 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
So‘rov namunalari
Ailoot Ultra · 3D
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
Natijalarni olish va saqlash
Ailoot Ultra · 3D
Har bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Barcha tayyor natijalarni saqlash
Qaytarilgan har bir to‘liq javob, fayl va kontent qismini saqlang.
To‘liq javob va sarlavhalarni, dastlabki identifikatorlarni, har bir haqiqiy chiqishni va barcha foydalanish/hisob-kitob maydonlarini saqlang. Egalik qilinadigan har bir noyob aktivni saqlang va unga ishora qiluvchi har bir vazifani saqlab qoling.
Asl javobni tekshirish kerak bo‘lsa
Qaytarilgan ochiq vazifa yoki operatsiya id sini va barcha sarlavhalarni saqlang. Faqat dastlabki vazifani o‘qing; unknown yoki result_pending_check boshqa yaratish so‘roviga ruxsat bermaydi.
Javob maydonlari
| Maydon | Tur |
|---|---|
Maydonid | Turstring |
Maydonpolling_url | Turstring |
Maydonprovider_task_id | Turstring |
Maydoncode | Turinteger |
Maydondata.task_id | Turstring |
Maydondata.status | Turstring |
Maydondata.progress | Turinteger |
Maydondata.output.* | Turstring |
Maydondata.result.*.url | Turstring |
Maydondata.result.*.type | Turstring |
Maydondata.thumbnail | Turstring |
Taxalluslar
Model taxalluslari
Ailoot Ultra tripo3d
Usul yo‘llari taxalluslari
Yuqorida ko‘rsatilgan usul yo‘llaridan foydalaning.
Chaqirish uchun tegishli ID lar
FAQ · Tripo: 3D Generation
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/3d/generations·tripo3d:text→model_3d,image- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/3d/generations·tripo3d:model,type,model_version,prompt