3D
Créer un modèle 3D
Crée une tâche de génération de modèle 3D
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.
tripo-h3.1Modè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.
text-to-3d ou image-to-3d. Facultatif ; déduit des entrées lorsqu'il est omis.
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.
Image encodée en base64 pour la génération image-to-3D.
URL publique d'une image pour la génération image-to-3D.
Format de sortie ; la prise en charge et les valeurs autorisées dépendent du modèle sélectionné.
Paramètre de qualité ; la prise en charge et les valeurs autorisées dépendent du modèle sélectionné.
Préréglage de style pour le modèle.
Seed entière, lorsqu'elle est prise en charge par le modèle sélectionné.
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
ID de la tâche pour interroger le statut.
Alias de l'identifiant de tâche asynchrone lorsqu'il est renvoyé par l'adaptateur.
URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.
Statut de la tâche : pending, processing, completed ou failed.
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
{
"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"
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.
1 <= length <= 255Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json