3D
3D Model Oluştur
Bir 3D model oluşturma görevi oluşturur
Tripo3D ve diğer sağlayıcıları kullanarak metin veya görsellerden 3D modeller oluşturun. Bu asenkron bir API'dir. Oluşturma yanıtları görev kimliğini döndürür ve uygun olduğunda tercih edilen poll_url değerini de içerebilir.
Herkese açık 3D operation değeri istek şekline göre çıkarılır: yalnızca prompt içeren istekler text-to-3d, image veya image_url içeren istekler image-to-3d olarak işlenir. Bu endpoint operation istek alanını sunmaz; legacy 3d-generation değerini göndermeyin.
İstek Gövdesi
İsteğe bağlı alanları göndermeden önce GET /v1/models/{model} ile modelin kabul ettiği parametreleri kontrol edin. Örnek yalnızca model ve prompt gönderir.
tripo-h3.1Kullanılacak model, örneğin tripo-h3.1 veya tripo-p1.0. Belirli bir giriş türü veya çıktı biçimine güvenmeden önce GET /v1/models?recommended_for=3d sorgulayın.
Oluşturulacak 3D modelin metin açıklaması.
Görselden 3D'ye üretim için Base64 kodlu görsel.
Görselden 3D'ye üretim için görselin URL'si.
Çıktı biçimi; 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 destekliyorsa kullanılabilen tam sayı seed.
Son kullanıcı için benzersiz bir tanımlayıcı.
Yanıt
Durum sorgulama için görev kimliği (Task ID).
Adaptör tarafından döndürüldüğünde asenkron görev kimliği takma adı.
Uygun olduğunda dönen öncelikli polling URL'si.
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"
İstek gövdesi
application/json
Yanıt
application/json
application/json