Passer au contenu principal
Générez des modèles 3D à partir de texte ou d’images en utilisant Tripo3D et d’autres fournisseurs. Il s’agit d’une API asynchrone. La réponse de création renvoie un identifiant de tâche et peut, lorsqu’il est disponible, inclure un poll_url à utiliser en priorité.

Corps de la requête

model
string
défaut:"tripo3d-v2.5"
Modèle à utiliser (par ex., tripo3d-v2.5, tripo3d-v2).
prompt
string
requis
Description textuelle du modèle 3D à générer.
image
string
Image encodée en Base64 pour la génération image-vers-3D.
image_url
string
URL de l’image pour la génération image-vers-3D.
format
string
défaut:"glb"
Format de sortie : glb, fbx, obj ou usdz.
quality
string
défaut:"standard"
Niveau de qualité : draft, standard ou high.
style
string
Préréglage de style pour le modèle.
seed
integer
Seed pour une génération reproductible.
user
string
Un identifiant unique pour l’utilisateur final.

Réponse

id
string
ID de la tâche pour le suivi du statut.
task_id
string
Alias de l’identifiant de tâche asynchrone lorsque l’adaptateur le renvoie.
poll_url
string
URL de polling prioritaire lorsqu’elle est disponible.
status
string
Statut de la tâche : pending, processing, completed ou failed.
created
integer
Horodatage Unix de la création de la tâche.
curl -X POST "https://api.lemondata.cc/v1/3d/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "A detailed medieval castle with towers",
    "format": "glb",
    "quality": "high"
  }'
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo3d-v2.5"
}