3D
Buat Model 3D
Membuat tugas pembuatan model 3D
Hasilkan model 3D dari teks atau gambar menggunakan Tripo3D dan penyedia lainnya. Ini adalah API asinkron. Respons create mengembalikan identitas tugas dan, ketika tersedia, juga dapat menyertakan poll_url yang diprioritaskan.
Operation 3D publik disimpulkan dari bentuk request: request yang hanya berisi prompt diproses sebagai text-to-3d, sedangkan request dengan image atau image_url diproses sebagai image-to-3d. Endpoint ini tidak mengekspos field request operation; jangan kirim nilai legacy 3d-generation.
Isi Permintaan
Sebelum mengirim field opsional, periksa parameter yang diterima model melalui GET /v1/models/{model}. Contoh hanya mengirim model dan prompt.
tripo-h3.1Model yang digunakan, misalnya tripo-h3.1 atau tripo-p1.0. Kueri GET /v1/models?recommended_for=3d sebelum bergantung pada jenis input atau format output tertentu.
Deskripsi teks dari model 3D yang akan dihasilkan.
Gambar dengan encoding Base64 untuk pembuatan image-to-3D.
URL gambar untuk pembuatan image-to-3D.
Format keluaran; dukungan dan nilai yang diizinkan bergantung pada model yang dipilih.
Pengaturan kualitas; dukungan dan nilai yang diizinkan bergantung pada model yang dipilih.
Preset gaya untuk model tersebut.
Seed bilangan bulat, jika didukung oleh model yang dipilih.
Pengidentifikasi unik untuk pengguna akhir.
Respons
ID tugas untuk polling status.
Alias identifier tugas asinkron ketika dikembalikan oleh adapter.
URL polling prioritas ketika tersedia.
Status tugas: pending, processing, completed, atau failed.
Timestamp Unix dari pembuatan tugas.
Permintaan
curl -X POST "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": "A detailed medieval castle with towers"
}'Respons
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Header
Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.
Nilai yang tersedia
- "auto"
- "verified"
- "official"
Body permintaan
application/json
Respons
application/json
application/json