Bild zu Multiview

POST /v3/generation/image-to-multiview

Generieren Sie Multiview-Bilder aus einem einzelnen Bild.

Anforderungsparameter

Anforderungsheader

Parameter	Typ	Erforderlich	Standard	Beschreibung
Content-Type	Zeichenfolge	Ja	-	`application/json`
Authorization	Zeichenfolge	Ja	-	`Bearer {api_key}`

Anforderungstext

Parameter	Typ	Erforderlich	Standard	Beschreibung
input	Zeichenfolge	Ja	-	Quellbild. Unterstützt `file_token` oder ein Bild URL

Fordern Sie Beispiele an

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);

Antwort

Erfolgsantwort

JSON

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

Nachdem die Aufgabe abgeschlossen ist, fragen Sie die Aufgabe API ab, um die Multiview-Ausgabe abzurufen:

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"
    }
  }
}

Antwortfelder

Parameter	Typ	Beschreibung
code	ganze Zahl	Statuscode. `0` zeigt Erfolg an
data.task_id	Zeichenfolge	Eindeutiger Aufgabenbezeichner, der zum Abfragen des Generierungsfortschritts und der Ergebnisse verwendet wird
data.output.front_view_url	Zeichenfolge	Vorderansichtbild URL
data.output.left_view_url	Zeichenfolge	Bild der linken Ansicht URL
data.output.back_view_url	Zeichenfolge	Rückansichtsbild URL
data.output.right_view_url	Zeichenfolge	Bild der rechten Ansicht URL

Fehlercodes

HTTP Statuscode	Fehlercode	Beschreibung	Empfehlung
429	2000	Generationslimit überschritten	Reduzieren Sie die Anforderungshäufigkeit und versuchen Sie es später noch einmal
400	2002	Nicht unterstützter Anforderungsparameter	Überprüfen Sie die Parameternamen und Wertebereiche des Anforderungshauptteils
400	2003	Die Eingabedatei ist leer	Bestätigen Sie, dass `input` auf eine gültige Bildressource verweist
400	2004	Nicht unterstützter Dateityp	Verwenden Sie ein unterstütztes Bildformat (PNG, JPEG, WebP).
400	2008	Die Eingabe verstößt gegen die Inhaltsrichtlinien	Überarbeiten Sie das Eingabebild und entfernen Sie Inhalte, die gegen die Richtlinien verstoßen
403	2010	Unzureichende Credits	Fügen Sie Credits hinzu und versuchen Sie es erneut