TokenLab

3D

Créer un modèle 3D

Crée une tâche de génération de modèle 3D

POST
/v1/3d/generations

Utilisez GET /v1/models?recommended_for=3d pour obtenir les modèles 3D actuels.

Générez des modèles 3D à partir de texte ou d'images. Il s'agit d'une API asynchrone. Les réponses de création renvoient un identifiant de tâche. Interrogez GET /v1/tasks/{id} avec celui-ci pour obtenir le statut.

L'opération est text-to-3d ou image-to-3d. Vous pouvez omettre operation : les requêtes contenant uniquement un prompt sont résolues en text-to-3d, et les requêtes avec image ou image_url sont résolues en image-to-3d. Si vous envoyez operation, elle doit correspondre aux entrées : image-to-3d nécessite une image, et text-to-3d n'en prend aucune. L'ancienne valeur 3d-generation renvoie 400 unsupported_operation. Chaque modèle ne prend en charge que certaines opérations ; vérifiez GET /v1/models/{model}.

Corps de la requête

Avant d'envoyer des champs facultatifs, vérifiez GET /v1/models/{model} pour connaître les paramètres acceptés par le modèle. L'exemple utilise uniquement model et prompt.

modelstringpar défaut: tripo-h3.1

Modèle à utiliser, par exemple tripo-h3.1 ou tripo-p1.0. Interrogez GET /v1/models?recommended_for=3d avant de vous fier à un type d'entrée ou à un format de sortie spécifique.

operationstring

text-to-3d ou image-to-3d. Facultatif ; déduit des entrées lorsqu'il est omis.

promptstringrequis

Description textuelle du modèle 3D à générer, jusqu'à 2 000 caractères. Les modèles peuvent définir une limite plus courte ; consultez leurs détails. Les requêtes Image-to-3D nécessitent également un prompt pour les modèles actuels ; sans celui-ci, la requête renvoie 400 prompt is required.

imagestring

Image encodée en base64 pour la génération image-to-3D.

image_urlstring

URL publique d'une image pour la génération image-to-3D.

formatstring

Format de sortie ; la prise en charge et les valeurs autorisées dépendent du modèle sélectionné.

qualitystring

Paramètre de qualité ; la prise en charge et les valeurs autorisées dépendent du modèle sélectionné.

stylestring

Préréglage de style pour le modèle.

seedinteger

Seed entière, lorsqu'elle est prise en charge par le modèle sélectionné.

userstring

Un identifiant unique pour l'utilisateur final. Envoyez-le uniquement lorsque le modèle sélectionné l'accepte.

Certains modèles listent également n, negative_prompt et output_format (un alias de format). Ne les envoyez que lorsque les détails du modèle les listent.

Réponse

idstring

ID de la tâche pour interroger le statut.

task_idstring

Alias de l'identifiant de tâche asynchrone lorsqu'il est renvoyé par l'adaptateur.

poll_urlstring

URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.

statusstring

Statut de la tâche : pending, processing, completed ou failed.

createdinteger

Timestamp Unix de 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

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo-h3.1"
}

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

Clé optionnelle qui permet de réessayer une requête de création en toute sécurité. Envoyez une nouvelle valeur unique, telle qu'un UUID, pour chaque tâche. Une tentative avec la même clé et le même corps renvoie le résultat de la requête de création initiale, généralement la tâche d'origine, et ne crée, ne distribue ni ne facture une seconde tâche. Un corps différent avec une clé déjà acceptée est rejeté avec 409. Une clé de plus de 255 caractères est ignorée, et la requête ne bénéficie alors d'aucune protection d'idempotence. Voir Réessayer en toute sécurité avec une clé d'idempotence.

Longueur1 <= length <= 255

Corps de la requête

application/json

Réponse

application/json

application/json

application/json

application/json

application/json

application/json