aisplice

Riferimento API

Modelli 3D

Modelli su questo endpoint (1)

tripo-3d
Provalo nel Workbench
POST/v1/model3d/tasks
GET/v1/model3d/tasks/{task_id}

Generazione 3D asincrona e post-elaborazione. Un solo campo, operation, sceglie cosa fa il task: crea un modello da testo, da un'immagine o da più viste, poi applica texture, segmentalo, rifanne la topologia o aggiungi il rigging. L'invio restituisce un task_id; interrogalo finché l'URL del modello non arriva nel corpo del task.

#Parametri della richiesta

  • modelstringobbligatorio

    Un ID di modello 3D dal catalogo, per esempio tripo-3d.

  • operationstringobbligatorio

    text_to_model · image_to_model · multiview_to_model · texture · smart_segment · retopology · rig · animate.

  • promptstringfacoltativo

    Cosa creare. Usato da text_to_model.

  • inputstringfacoltativo

    Un URL pubblico di un'immagine per image_to_model, oppure il task_id di un modello 3D completato per texture, smart_segment, retopology, rig e animate.

  • inputsobject[]facoltativo

    multiview_to_model: [{"front": url}, {"left": url}, …] — una vista frontale più almeno un'altra.

  • texturebooleanfacoltativo

    Genera le texture insieme al modello.

  • pbrbooleanfacoltativo

    Genera materiali PBR.

  • texture_promptobjectfacoltativo

    texture: {"text": "weathered bronze"} descrive la nuova superficie.

  • face_limitintegerfacoltativo

    retopology: il numero massimo di facce che il risultato può avere.

  • quadbooleanfacoltativo

    retopology: mesh a quad invece che a triangoli.

  • animationstringfacoltativo

    animate: l'animazione da applicare a un modello con rigging.

#Errori correlati

  • 404 not_foundtask_id sconosciuto, oppure il task di input di un passaggio successivo non esiste o non è completato.
  • 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
  • 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
  • 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
  • 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.

Tabella completa dei codici di errore →

#Esempio di richiesta

# 1. make a model from text
curl https://www.aisplice.store/v1/model3d/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "tripo-3d", "operation": "text_to_model", "prompt": "A small ceramic fox", "texture": true}'

# 2. poll until status is completed; the file is in url
curl https://www.aisplice.store/v1/model3d/tasks/$TASK_ID -H "Authorization: Bearer sk-YOUR_KEY"

# 3. texture it: pass the finished task_id as input
curl https://www.aisplice.store/v1/model3d/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "tripo-3d", "operation": "texture", "input": "'$TASK_ID'", "texture_prompt": {"text": "weathered bronze"}}'

#Risposta

response.json
// POST /v1/model3d/tasks
{"task_id": "task_xxx", "status": "queued"}

// GET /v1/model3d/tasks/{task_id} — after completion
{"task_id": "task_xxx", "status": "completed", "url": "https://…/model.glb", "output": {"model_url": "https://…/model.glb"}}

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteMusicaSuccessivoPolicy di upload dei file