Görüntüyü Çoklu Görünüme Dönüştürme

POST /v3/generation/image-to-multiview

Tek bir görüntüden çoklu görünüm görüntüleri oluşturun.

İstek Parametreleri

Başlıkları Talep Et

Parametre	Tür	Gerekli	Varsayılan	Açıklama
Content-Type	dize	Evet	-	`application/json`
Authorization	dize	Evet	-	`Bearer {api_key}`

Talep Gövdesi

Parametre	Tür	Gerekli	Varsayılan	Açıklama
input	dize	Evet	-	Kaynak görseli. `file_token` veya bir URL görüntüsünü destekler

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/generation/image-to-multiview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "https://example.com/character.png"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/image-to-multiview"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "https://example.com/character.png"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/image-to-multiview";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "https://example.com/character.png"
  })
});

const data = await response.json();
console.log(data);

Yanıt

Başarı Yanıtı

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}

Görev tamamlandıktan sonra çoklu görüntüleme çıktısını almak için API görevini sorgulayın:

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "status": "success",
    "output": {
      "front_view_url": "https://cdn.tripo3d.ai/front.png",
      "left_view_url": "https://cdn.tripo3d.ai/left.png",
      "back_view_url": "https://cdn.tripo3d.ai/back.png",
      "right_view_url": "https://cdn.tripo3d.ai/right.png"
    }
  }
}

Yanıt Alanları

Parametre	Tür	Açıklama
code	tamsayı	Durum kodu. `0` başarıyı gösterir
data.task_id	dize	Oluşturma ilerlemesini ve sonuçlarını sorgulamak için kullanılan benzersiz görev tanımlayıcı
data.output.front_view_url	dize	Önden görünüş resmi URL
data.output.left_view_url	dize	Soldan görünüş resmi URL
data.output.back_view_url	dize	Arkadan görünüm resmi URL
data.output.right_view_url	dize	Sağdan görünüş resmi URL

Hata Kodları

HTTP Durum Kodu	Hata Kodu	Açıklama	Tavsiye
429	2000	Üretim sınırı aşıldı	İstek sıklığını azaltın ve daha sonra yeniden deneyin
400	2002	Desteklenmeyen istek parametresi	İstek gövdesi parametre adlarını ve değer aralıklarını kontrol edin
400	2003	Giriş dosyası boş	`input`’nin geçerli bir görüntü kaynağına işaret ettiğini doğrulayın
400	2004	Desteklenmeyen dosya türü	Desteklenen bir resim formatı kullanın (PNG, JPEG, WebP)
400	2008	Giriş içerik politikasını ihlal ediyor	Giriş görselini gözden geçirin ve politikayı ihlal eden içeriği kaldırın
403	2010	Yetersiz kredi	Kredi ekleyin ve yeniden deneyin