Generasi 3D

Generasi 3D bersifat asinkron. POST /v1/3d/generations membuat tugas TokenLab; respons status yang selesai mengembalikan aset model yang dapat diunduh seperti model_url dan, ketika tersedia, URL spesifik format.

Pilih Jenis InputCopy Anchor Link

Kueri katalog model sebelum memutuskan opsi mana yang akan diekspos:

Gunakan jenis input, bukan field operation, untuk endpoint ini. Metadata model melaporkan kemampuan 3D sebagai text-to-3d dan/atau image-to-3d; 3d-generation bukan operation request publik.

curl "https://api.tokenlab.sh/v1/models?recommended_for=3d" \
  -H "Authorization: Bearer sk-your-api-key"

Contoh Tripo saat ini mencakup tripo-h3.1 untuk alur text/image-to-3D berkualitas tinggi dan tripo-p1.0 untuk pembuatan aset 3D bergaya produksi. Gunakan Models API untuk memastikan jenis input dan format output yang dipilih.

Jangan menganggap setiap model 3D mendukung kedua jenis input atau setiap format output. Periksa kontrak model yang dipilih sebelum mengirim image, image_url, format, quality, style, atau seed.

Buat Tugas 3DCopy Anchor Link

curl https://api.tokenlab.sh/v1/3d/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo-h3.1",
    "prompt": "Sebuah maskot robot low-poly bergaya dengan topologi yang bersih"
  }'

Untuk gambar-ke-3D, gunakan image_url publik jika memungkinkan. Gunakan image inline/base64 hanya ketika klien Anda sengaja mengirim media pribadi dan backend Anda siap untuk tubuh permintaan yang lebih besar.

Pilihan Format OutputCopy Anchor Link

• glb biasanya adalah default yang paling aman untuk pratinjau web.
• fbx dan obj berguna untuk alur kerja DCC ketika model yang dipilih mendukungnya.
• usdz berguna untuk alur kerja AR Apple ketika diekspos oleh model.
• Nilai quality yang lebih tinggi dapat meningkatkan latensi dan biaya. Ekspos sebagai pilihan pengguna yang eksplisit, bukan default tersembunyi.
• seed berguna untuk reproduktifitas hanya ketika model menghormatinya.

Polling dan Simpan AsetCopy Anchor Link

Gunakan poll_url yang dikembalikan terlebih dahulu. Jika klien Anda memerlukan rute tetap, gunakan GET /v1/tasks/{id}.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

Tugas yang selesai mengembalikan model_url dan mungkin menyertakan glb_url, fbx_url, obj_url, atau usdz_url. Unduh atau cache aset yang dipilih dalam produk Anda sendiri jika pengguna memerlukan akses ulang, riwayat versi, atau unduhan jangka panjang.

Daftar Periksa ProduksiCopy Anchor Link

• Simpan task_id, poll_url, model, format yang diminta, dan ID catatan aset Anda sendiri.
• Lanjutkan polling setelah penyegaran halaman daripada membuat tugas duplikat.
• Validasi ukuran dan keterjangkauan gambar sumber sebelum membuat tugas.
• Jaga agar URL aset yang dihasilkan tidak muncul di halaman publik kecuali pengguna memiliki izin untuk mengakses aset tersebut.
• Catat billing_transaction_id ketika ada untuk rekonsiliasi di kemudian hari.

Kesalahan UmumCopy Anchor Link

Referensi APICopy Anchor Link