3D

Buat Model 3D

Membuat tugas pembuatan model 3D

POST
/v1/3d/generations

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.

modelstringbawaan: tripo-h3.1

Model 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.

operationstring

text-to-3d atau image-to-3d. Opsional; disimpulkan dari input jika tidak ditentukan.

promptstringwajib

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.

imagestring

Gambar berenkode Base64 untuk pembuatan image-to-3D.

image_urlstring

URL publik gambar untuk pembuatan image-to-3D.

formatstring

Format output; dukungan dan nilai yang diizinkan bergantung pada model yang dipilih.

qualitystring

Pengaturan kualitas; dukungan dan nilai yang diizinkan bergantung pada model yang dipilih.

stylestring

Preset gaya untuk model tersebut.

seedinteger

Seed bilangan bulat, jika didukung oleh model yang dipilih.

userstring

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

idstring

ID tugas untuk polling status.

task_idstring

Alias pengidentifikasi tugas asinkron saat dikembalikan oleh adapter.

poll_urlstring

URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.

statusstring

Status tugas: pending, processing, completed, atau failed.

createdinteger

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

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo-h3.1"
}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

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.

Panjang1 <= length <= 255

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json

application/json

application/json