Tripo: 3D Generation

Tripo membuat aset model 3D dari deskripsi objek tertulis. Alur kerja pembuatnya yang lebih luas membedakan geometri, pemberian tekstur, dan pemrosesan model berikutnya; periksa mesh yang selesai dari beberapa sudut pandang dan simpan berkas aslinya untuk adegan atau editor tujuan.

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

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

Tripo membuat aset model 3D dari deskripsi atau referensi visual. Alur kerjanya memisahkan pembuatan objek dari tahap berikutnya, seperti pemberian tekstur, rigging, dan konversi. Mulailah dengan menentukan aset yang dituju dan operasi yang menghasilkannya: mesh statis untuk adegan, objek bertekstur untuk rendering, atau model yang akan dipersiapkan lebih lanjut dalam editor 3D.

Untuk deskripsi teks ke model, jelaskan bentuk objek dan bagian pentingnya. Lentera kecil dapat dijelaskan melalui badan, pegangan, bukaan, dan proporsinya; makhluk melalui siluet, anggota tubuh, dan posenya. Sebutkan bahan atau perlakuan visual jika berpengaruh pada hasil. Jaga agar deskripsi berfokus pada objek itu sendiri sehingga geometri yang dihasilkan dapat dinilai berdasarkan rancangan yang jelas.

Untuk alur kerja pembuat berbasis referensi, siapkan gambar yang memperlihatkan garis luar subjek dan ciri pembeda. Beberapa sudut pandang harus menggambarkan objek yang sama dengan proporsi dan aksesori yang konsisten. Tinjau bagian yang tersembunyi dalam referensi setelah pembuatan, karena tampilan depan yang meyakinkan tidak membuktikan bahwa bagian belakang, bawah, atau sambungan antarkomponen sesuai dengan rancangan yang dituju.

Simpan versi model yang dipilih bersama permintaan. Antarmuka pembuatan Tripo mengidentifikasi operasi secara terpisah dari pengaturan versi model, dan contoh teks ke model yang didokumentasikan memilih versi secara eksplisit. Pertahankan versi dan kontrol yang persis sama saat membandingkan aset agar perubahan deskripsi objek tidak tertukar dengan perubahan konfigurasi pembuatan.

Geometri dan tampilan permukaan merupakan keputusan produksi yang terpisah. Alur kerja dasar pembuatnya membedakan model tanpa tekstur dari keluaran dengan tekstur dan material untuk rendering berbasis fisika. Pilih bentuk aset yang diperlukan untuk tahap berikutnya, lalu periksa mesh dan berkas material yang menyertainya. Gambar pratinjau berguna untuk orientasi, sedangkan model sebenarnya adalah aset yang dibutuhkan untuk penyusunan adegan dan penyuntingan lebih lanjut.

Periksa objek yang selesai dari beberapa sudut. Amati siluet, pemisahan bagian, detail tipis, bukaan, dan permukaan tempat komponen bertemu. Untuk properti adegan bergaya, bandingkan proporsinya dengan deskripsi rancangan. Untuk objek yang menyerupai produk, periksa detail mana yang diwujudkan oleh geometri dan mana yang hanya tampak pada perlakuan permukaan. Tentukan ciri yang perlu direvisi sebelum mengubah prompt atau referensi.

Pembuatan berjalan sebagai tugas asinkron. Pertahankan identitas tugas asli selama pemeriksaan status dan simpan model yang selesai, pratinjau, serta berkas lain yang dikembalikan bersama-sama. Hasil yang didokumentasikan mencakup field keluaran terkait model dan gambar hasil rendering. Simpan berkas itu sendiri untuk tahap produksi berikutnya, alih-alih mengandalkan tautan hasil sementara atau menganggap pratinjau sebagai seluruh hasil 3D.

Impor model ke editor atau lingkungan penampil yang dituju dan periksa orientasi, skala, material, serta geometrinya di sana. Properti adegan, rendering jarak dekat, dan karakter yang siap dianimasikan memiliki kebutuhan penyelesaian yang berbeda. Simpan salinan kerja untuk penyuntingan dan pertahankan aset sumber yang dihasilkan bersama deskripsi serta referensinya. Jika diperlukan operasi lain, seperti pengerjaan tekstur atau rigging, pilih operasi tersebut dengan sengaja dan tinjau aset yang dihasilkan sebagai tahap terpisah.

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

tripo3d

Tripo /tripo3d

Mulai

Masukan yang diterima: Teks
Hasil: model_3d · Gambar

Tersedia di Ailoot · masukan & metode

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

Masukan: text
Keluaran: model_3d, image

Kolom	Jenis	Persyaratan	Nilai & batasan	Bawaan
Kolom`model`	Jenis`string`	PersyaratanWajib	Nilai & batasan tripo3d Kondisi: Gunakan pemilih model Ailoot.	Bawaan—
Kolom`type`	Jenis`string`	PersyaratanWajib	Nilai & batasan text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Kondisi: Contoh lengkap menggunakan text_to_model; tipe tugas lain memerlukan masukan khusus tugas yang didokumentasikan untuknya.	Bawaan—
Kolom`model_version`	Jenis`string`	PersyaratanWajib	Nilai & batasan v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Kondisi: Pilih versi yang didokumentasikan secara eksplisit; contoh ini menggunakan v3.0-20250812.	Bawaan—
Kolom`prompt`	Jenis`string`	PersyaratanWajib	Nilai & batasan Kondisi: Jelaskan objek yang akan dibuat.	Bawaan—

Parameter metode dan siklus hidup

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; tipe tugas lain memerlukan masukan khusus tugas yang didokumentasikan untuknya., Pilih versi yang didokumentasikan secara eksplisit; contoh ini menggunakan v3.0-20250812., Jelaskan objek yang akan dibuat.

Siklus hidup: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Paket

Cara menghitung biaya akhir

Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast: Tidak ditentukan Saat mode fast dipilih
Mode Flex: Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum: Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

Konfigurasi	Jadwal tarif	Jumlah perkiraan	Biaya
KonfigurasiTarif dasar token	Jadwal tarifTarif dasar	Jumlah perkiraan—	Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token
KonfigurasiPerkiraan biaya pembuatan	Jadwal tarif—	Jumlah perkiraanestimasi satu kali pembuatan	Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $1.35 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot Ultra · 3D

curl · buat sekali dan simpan tanda terimaBaca tugas asliSimpan setiap aset milik Anda yang telah selesai

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

Unduh setiap gambar yang dikembalikan atau simpan konten 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, berkas, dan bagian konten yang dikembalikan.

Simpan respons dan header secara utuh, pengenal asli, setiap keluaran aktual, dan semua bidang penggunaan/akuntansi. Simpan setiap aset unik milik Ailoot dan pertahankan setiap peran yang menunjuk kepadanya.

Jika respons asli perlu diperiksa

Simpan id tugas atau operasi publik yang dikembalikan beserta semua header. Baca hanya tugas awal; unknown atau result_pending_check tidak mengizinkan pembuatan lain.

Kolom respons

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

Alias

Alias model

Ailoot Ultra tripo3d

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

tripo3d

FAQ · Tripo: 3D Generation

Input dan hasil apa yang tersedia?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Kolom apa yang digunakan permintaan?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation