Immagine in visualizzazione multipla

POST /v3/generation/image-to-multiview

Genera immagini multivista da una singola immagine.

Richiedi parametri

Richiedi intestazioni

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
Content-Type	stringa	Sì	-	`application/json`
Authorization	stringa	Sì	-	`Bearer {api_key}`

Richiedi corpo

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
input	stringa	Sì	-	Immagine di origine. Supporta `file_token` o un’immagine URL

Richiedi esempi

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

Risposta

Risposta di successo

JSON

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

Una volta completata l’attività, interrogare l’attività API per recuperare l’output multivista:

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

Campi di risposta

Parametro	Digitare	Descrizione
code	intero	Codice di stato. `0` indica successo
data.task_id	stringa	Identificatore univoco dell’attività utilizzato per interrogare l’avanzamento e i risultati della generazione
data.output.front_view_url	stringa	Immagine vista frontale URL
data.output.left_view_url	stringa	Immagine vista da sinistra URL
data.output.back_view_url	stringa	Immagine vista posteriore URL
data.output.right_view_url	stringa	Immagine vista da destra URL

Codici di errore

HTTP Codice di stato	Codice errore	Descrizione	Raccomandazione
429	2000	Limite di generazione superato	Ridurre la frequenza delle richieste e riprovare più tardi
400	2002	Parametro di richiesta non supportato	Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori
400	2003	Il file di input è vuoto	Conferma che `input` punta a una risorsa immagine valida
400	2004	Tipo di file non supportato	Utilizza un formato immagine supportato (PNG, JPEG, WebP)
400	2008	L’input viola le norme sui contenuti	Rivedi l’immagine di input e rimuovi i contenuti che violano le policy
403	2010	Crediti insufficienti	Aggiungi crediti e riprova