3D
3D Model Oluştur
Bir 3D model oluşturma görevi yaratır
Güncel 3D modelleri almak için GET /v1/models?recommended_for=3d kullanın.
Metin veya görsellerden 3D modeller oluşturun. Bu, asenkron bir API'dir. Oluşturma yanıtları bir görev kimliği döndürür. Durumu öğrenmek için bu kimlikle GET /v1/tasks/{id} uç noktasına sorgu yapın.
İşlem text-to-3d veya image-to-3d şeklindedir. operation alanını boş bırakabilirsiniz: yalnızca istem (prompt) içeren istekler text-to-3d olarak çözümlenir, image veya image_url içeren istekler ise image-to-3d olarak çözümlenir. Eğer operation gönderirseniz, girdilerle eşleşmelidir: image-to-3d bir görsel gerektirir, text-to-3d ise görsel almaz. Eski 3d-generation değeri 400 unsupported_operation hatası döndürür. Her model yalnızca belirli işlemleri destekler; GET /v1/models/{model} üzerinden kontrol edin.
İstek Gövdesi (Request Body)
İsteğe bağlı alanları göndermeden önce, modelin kabul ettiği parametreler için GET /v1/models/{model} uç noktasını kontrol edin. Örnekte yalnızca model ve prompt kullanılmıştır.
tripo-h3.1Kullanılacak model; örneğin tripo-h3.1 veya tripo-p1.0. Belirli bir girdi türüne veya çıktı formatına güvenmeden önce GET /v1/models?recommended_for=3d sorgusu yapın.
text-to-3d veya image-to-3d. İsteğe bağlıdır; belirtilmediğinde girdilerden çıkarım yapılır.
Oluşturulacak 3D modelin 2000 karaktere kadar metin açıklaması. Modeller daha kısa bir sınır belirleyebilir; detaylarına bakın. Image-to-3D istekleri de mevcut modeller için bir prompt gerektirir; aksi takdirde istek 400 prompt is required hatası döndürür.
Image-to-3D oluşturma için Base64 kodlu görsel.
Image-to-3D oluşturma için görselin herkese açık URL adresi.
Çıktı formatı; destek ve izin verilen değerler seçilen modele bağlıdır.
Kalite ayarı; destek ve izin verilen değerler seçilen modele bağlıdır.
Model için stil ön ayarı.
Seçilen model tarafından desteklendiğinde kullanılan tam sayı (integer) seed değeri.
Son kullanıcı için benzersiz bir tanımlayıcı. Yalnızca seçilen model kabul ettiğinde gönderin.
Bazı modeller ayrıca n, negative_prompt ve output_format (format parametresinin bir diğer adı) parametrelerini de listeler. Bunları yalnızca modelin detaylarında listelendikleri durumlarda gönderin.
Yanıt (Response)
Durum sorgulama için görev kimliği.
Adaptör tarafından döndürüldüğünde asenkron görev tanımlayıcı takma adı.
Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.
Görev durumu: pending, processing, completed veya failed.
Görevin oluşturulma zamanına ait Unix zaman damgası.
İstek
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"
}'Yanıt
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
Oluşturma isteğinin güvenli bir şekilde yeniden denenmesini sağlayan isteğe bağlı anahtar. Her görev için UUID gibi yeni ve benzersiz bir değer gönderin. Aynı anahtar ve aynı gövde ile yapılan bir yeniden deneme, orijinal oluşturma isteğinin sonucunu (genellikle orijinal görevi) döndürür ve ikinci bir görev oluşturmaz, göndermez veya ücretlendirmez. Daha önce kabul edilmiş bir anahtara sahip farklı bir gövde, 409 hatası ile reddedilir. 255 karakterden uzun bir anahtar yok sayılır ve bu durumda isteğin idempotency koruması olmaz. Bkz: Idempotency anahtarı ile güvenli yeniden deneme.
1 <= length <= 255İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json