3D
Buat Model 3D
Membuat tugas pembuatan model 3D
Gunakan GET /v1/models?recommended_for=3d untuk mendapatkan model 3D saat ini.
Hasilkan model 3D dari teks atau gambar. Ini adalah API asinkron. Respons pembuatan mengembalikan identitas tugas. Lakukan polling GET /v1/tasks/{id} dengannya untuk mengetahui status.
Operasi berupa text-to-3d atau image-to-3d. Anda dapat mengabaikan operation: permintaan hanya prompt akan diarahkan ke text-to-3d, dan permintaan dengan image atau image_url akan diarahkan ke image-to-3d. Jika Anda mengirimkan operation, nilainya harus cocok dengan input: image-to-3d memerlukan gambar, dan text-to-3d tidak memerlukan gambar. Nilai lawas 3d-generation mengembalikan 400 unsupported_operation. Setiap model hanya mendukung operasi tertentu; periksa GET /v1/models/{model}.
Body Permintaan
Sebelum mengirimkan bidang opsional, periksa GET /v1/models/{model} untuk parameter yang diterima oleh model tersebut. Contoh ini hanya menggunakan model dan prompt.
tripo-h3.1Model yang akan digunakan, misalnya tripo-h3.1 atau tripo-p1.0. Lakukan kueri GET /v1/models?recommended_for=3d sebelum bergantung pada tipe input atau format output tertentu.
text-to-3d atau image-to-3d. Opsional; disimpulkan dari input jika tidak ditentukan.
Deskripsi teks model 3D yang akan dibuat, hingga 2000 karakter. Model dapat menetapkan batas yang lebih pendek; lihat detailnya. Permintaan Image-to-3D juga memerlukan prompt untuk model saat ini; tanpanya, permintaan akan mengembalikan 400 prompt is required.
Gambar berenkode Base64 untuk pembuatan image-to-3D.
URL publik gambar untuk pembuatan image-to-3D.
Format output; 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. Kirimkan hanya jika model yang dipilih menerimanya.
Beberapa model juga mencantumkan n, negative_prompt, dan output_format (alias dari format). Kirimkan parameter tersebut hanya jika detail model mencantumkannya.
Respons
ID tugas untuk polling status.
Alias pengidentifikasi tugas asinkron saat dikembalikan oleh adapter.
URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.
Status tugas: pending, processing, completed, atau failed.
Timestamp Unix 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"
Kunci opsional yang membuat permintaan pembuatan aman untuk dicoba ulang. Kirim nilai unik baru, seperti UUID, untuk setiap tugas. Percobaan ulang dengan kunci dan body yang sama akan mengembalikan hasil dari permintaan pembuatan asli, biasanya berupa tugas asli, dan tidak akan membuat, mengirim, atau mengenakan biaya untuk tugas kedua. Body yang berbeda dengan kunci yang sudah diterima akan ditolak dengan 409. Kunci yang lebih panjang dari 255 karakter akan diabaikan, dan permintaan tersebut tidak akan memiliki perlindungan idempotensi. Lihat Retry safely with an idempotency key.
1 <= length <= 255Body permintaan
application/json
Respons
application/json
application/json
application/json
application/json
application/json
application/json