Tripo: 3D Generation

Tripo menghasilkan aset model 3D daripada penerangan objek bertulis. Aliran kerja pembuatnya yang lebih luas membezakan geometri, penteksturan dan pemprosesan model seterusnya; periksa jejaring yang siap dari beberapa sudut pandangan dan simpan fail sebenar untuk adegan atau editor sasaran.

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

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Tripo menghasilkan aset model 3D daripada penerangan atau rujukan visual. Aliran kerjanya memisahkan penjanaan objek daripada langkah seterusnya seperti penteksturan, rigging dan penukaran. Mulakan dengan mengenal pasti aset yang dimaksudkan dan operasi yang menghasilkannya: jejaring statik untuk adegan, objek bertekstur untuk rendering atau model yang akan disediakan lebih lanjut dalam editor 3D.

Untuk penerangan teks kepada model, jelaskan bentuk objek dan bahagian pentingnya. Tanglung kecil boleh diperincikan melalui badan, pemegang, bukaan dan nisbah bahagiannya; makhluk melalui siluet, anggota dan posenya. Nyatakan bahan atau olahan visual apabila ia penting kepada hasil. Fokuskan penerangan pada objek itu sendiri supaya geometri yang dihasilkan dapat dinilai berdasarkan reka bentuk yang jelas.

Untuk aliran kerja pembuat yang berasaskan rujukan, sediakan imej yang menunjukkan garis luar subjek dan ciri pembezanya. Beberapa pandangan perlu menggambarkan objek yang sama dengan nisbah bahagian dan aksesori yang konsisten. Semak bahagian yang tersembunyi dalam rujukan selepas penjanaan, kerana pandangan hadapan yang meyakinkan tidak membuktikan bahawa bahagian belakang, bawah atau sambungan antara komponen sepadan dengan reka bentuk yang dimaksudkan.

Simpan versi model yang dipilih bersama permintaan. Antara muka penjanaan Tripo mengenal pasti operasi secara berasingan daripada tetapan versi model, dan contoh teks kepada model yang didokumentasikan memilih versi secara jelas. Kekalkan versi dan kawalan yang tepat apabila membandingkan aset supaya perubahan penerangan objek tidak dikelirukan dengan perubahan konfigurasi penjanaan.

Geometri dan rupa permukaan ialah keputusan pengeluaran yang berasingan. Aliran kerja asas pembuatnya membezakan model tanpa tekstur daripada output dengan tekstur dan bahan rendering berasaskan fizik. Pilih bentuk aset yang diperlukan untuk langkah seterusnya, kemudian periksa jejaring dan sebarang fail bahan yang disertakan. Imej pratonton berguna untuk orientasi, sementara model sebenar ialah artifak yang diperlukan untuk penyusunan adegan dan penyuntingan lanjut.

Periksa objek yang siap dari beberapa sudut. Lihat siluet, pemisahan bahagian, ciri nipis, bukaan dan permukaan tempat komponen bertemu. Untuk prop bergaya, bandingkan nisbah bahagiannya dengan penerangan reka bentuk. Untuk objek yang menyerupai produk, semak butiran yang diwakili oleh geometri dan butiran yang hanya kelihatan dalam olahan permukaan. Kenal pasti ciri yang perlu disemak sebelum mengubah prompt atau rujukan.

Penjanaan berjalan sebagai tugas tak segerak. Kekalkan identiti tugas asal sepanjang semakan status dan simpan model yang siap, pratonton serta sebarang fail lain yang dikembalikan bersama-sama. Hasil yang didokumentasikan merangkumi medan output berkaitan model dan imej yang dirender. Simpan fail itu sendiri untuk langkah pengeluaran seterusnya dan jangan bergantung pada pautan hasil sementara atau menganggap pratonton sebagai keseluruhan hasil 3D.

Import model ke editor atau persekitaran paparan yang dimaksudkan dan periksa orientasi, skala, bahan serta geometrinya di situ. Prop adegan, rendering jarak dekat dan watak yang sedia untuk animasi mempunyai keperluan kemasan yang berbeza. Simpan salinan kerja untuk penyuntingan dan kekalkan aset sumber yang dijana bersama penerangan serta rujukannya. Apabila operasi lain diperlukan, seperti kerja tekstur atau rigging, pilih operasi itu secara terancang dan semak aset yang terhasil sebagai tahap berasingan.

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

tripo3d

Tripo /tripo3d

Pengenalan

Input yang diterima: Teks
Hasil: model_3d · Imej

Tersedia di Ailoot · input & kaedah

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

Input: text
Output: model_3d, image

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had tripo3d Syarat: Gunakan pemilih model Ailoot.	Lalai—
Medan`type`	Jenis`string`	KeperluanDiperlukan	Nilai & had text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Syarat: Contoh lengkap menggunakan text_to_model; jenis tugas lain memerlukan input khusus tugas yang didokumenkan.	Lalai—
Medan`model_version`	Jenis`string`	KeperluanDiperlukan	Nilai & had v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Syarat: Pilih versi yang didokumenkan secara jelas; contoh ini menggunakan v3.0-20250812.	Lalai—
Medan`prompt`	Jenis`string`	KeperluanDiperlukan	Nilai & had Syarat: Huraikan objek yang hendak dicipta.	Lalai—

Parameter kaedah dan kitar hayat

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, type, model_version, prompt
Parameter`optional`	Kontrak
Parameter`material_types`	Kontraktext
Parameter`conditions`	KontrakGunakan pemilih model Ailoot., Contoh lengkap menggunakan text_to_model; jenis tugas lain memerlukan input khusus tugas yang didokumenkan., Pilih versi yang didokumenkan secara jelas; contoh ini menggunakan v3.0-20250812., Huraikan objek yang hendak dicipta.

Kitar hayat: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Pelan harga

Cara caj akhir dikira

Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas: Tidak dinyatakan Apabila mod pantas dipilih
Mod flex: Tidak dinyatakan Apabila mod flex dipilih
Usaha penaakulan maksimum: Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

Konfigurasi	Jadual kadar	Kuantiti ramalan	Caj
KonfigurasiKadar asas token	Jadual kadarKadar asas	Kuantiti ramalan—	Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token
KonfigurasiAnggaran kos penjanaan	Jadual kadar—	Kuantiti ramalananggaran untuk satu penjanaan	Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $1.35 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →

Contoh permintaan

Ailoot Ultra · 3D

curl · cipta sekali sahaja dan simpan rekod penerimaanBaca tugas asalSimpan setiap aset milik anda yang telah siap

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

Terima dan simpan hasil

Ailoot Ultra · 3D

Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya

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

Simpan semua hasil yang selesai

Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.

Simpan respons dan pengepala lengkap, pengecam asal, setiap output sebenar dan semua medan penggunaan/perakaunan. Simpan setiap aset unik milik anda dan kekalkan setiap peranan yang merujuk kepadanya.

Jika respons asal perlu disemak

Simpan id tugas atau operasi awam yang dikembalikan dan semua pengepala. Baca tugas asal sahaja; unknown atau result_pending_check tidak memberikan kebenaran untuk penciptaan lain.

Medan respons

Medan	Jenis
Medan`id`	Jenisstring
Medan`polling_url`	Jenisstring
Medan`provider_task_id`	Jenisstring
Medan`code`	Jenisinteger
Medan`data.task_id`	Jenisstring
Medan`data.status`	Jenisstring
Medan`data.progress`	Jenisinteger
Medan`data.output.*`	Jenisstring
Medan`data.result.*.url`	Jenisstring
Medan`data.result.*.type`	Jenisstring
Medan`data.thumbnail`	Jenisstring

Alias

Alias model

Ailoot Ultra tripo3d

Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

ID pemanggil berkaitan

tripo3d

FAQ · Tripo: 3D Generation

Apakah input dan hasil yang tersedia?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Apakah medan yang digunakan oleh permintaan?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation