3D
Créer un modèle 3D
Crée une tâche de génération de modèle 3D
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é.
Les opérations 3D publiques sont déduites de la forme de la requête : une requête avec seulement prompt devient text-to-3d, et une requête avec image ou image_url devient image-to-3d. Cet endpoint n'expose pas de champ de requête operation ; n'envoyez pas l'ancienne valeur 3d-generation.
Corps de la requête
Avant d’envoyer des champs facultatifs, consultez les paramètres acceptés par le modèle avec GET /v1/models/{model}. L’exemple envoie uniquement model et prompt.
tripo-h3.1Modèle à utiliser, par exemple tripo-h3.1 ou tripo-p1.0. Consultez GET /v1/models?recommended_for=3d avant de choisir un type d’entrée ou un format de sortie précis.
Description textuelle du modèle 3D à générer.
Image encodée en Base64 pour la génération image-vers-3D.
URL de l'image pour la génération image-vers-3D.
Format de sortie ; la prise en charge et les valeurs acceptées dépendent du modèle choisi.
Réglage de qualité ; la prise en charge et les valeurs acceptées dépendent du modèle choisi.
Préréglage de style pour le modèle.
Graine entière, si le modèle choisi la prend en charge.
Un identifiant unique pour l'utilisateur final.
Réponse
ID de la tâche pour le suivi du statut.
Alias de l'identifiant de tâche asynchrone lorsque l'adaptateur le renvoie.
URL de polling prioritaire lorsqu'elle est disponible.
Statut de la tâche : pending, processing, completed ou failed.
Horodatage Unix de la création de la tâche.
Requête
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'Réponse
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Corps de la requête
application/json
Réponse
application/json
application/json