Corps d'avatar Roblox
DisponibleDécrivez un personnage ou importez une image. Recevez un corps d'avatar complet en T-pose (FBX + GLB), prêt pour l'Avatar Setup de Roblox Studio. Payé par modèle sur votre solde.
Corps d'avatar Roblox
Entrée
Un corps complet en T-pose, sous la limite de 10 742 triangles de Roblox pour les corps. Vous le finalisez avec l’Avatar Setup de Roblox Studio (un seul passage) pour ajouter le rig R15.
promptCe qu'il faut créer, en mots.Comment fonctionne le pipeline 3D
Les mêmes étapes que nous utilisons pour créer les personnages de nos propres jeux.
- 01Vérification de la T-poseUn coup d'œil rapide à votre image. Si ce n'est pas une T-pose de face stricte, bouche fermée et neutre sur fond uni, elle est redessinée ainsi, avec le même personnage. Les bras tendus gardent les mains propres.
- 02Modèle 3DUn maillage texturé, prêt pour le jeu, créé à partir de l'image en T-pose, avec des matériaux PBR et sans éclairage incrusté. Personnages et accessoires ont leur propre budget de triangles.
- 03RigUn squelette ajusté au personnage pour qu'il puisse bouger, avec des clips de marche et de course sur demande. Vous recevez du FBX pour les moteurs de jeu et du GLB pour le web.
Lancez les trois étapes en un seul appel :Personnages 3D
Appelez Corps d'avatar Roblox depuis votre code
Chaque outil 3D est un endpoint à part. Chaque appel renvoie une tâche : interrogez-la jusqu'à la fin. Une exécution échouée n'est pas facturée.
https:/- GET
/Progression et fichiers de sortie.v1/ tasks/ {id} - GET
/Moteurs 3D et niveaux de qualité, avec les prixv1/ models? category= 3d
Obtenez une clé d’API
Créez une clé dans la console. Elle utilise le même solde que le playground.
Créer une cléEnvoyez votre première requête
La même requête que celle du playground. Définissez OPENNAN_KEY avec votre clé.
curl https://api.opennan.com/v1/roblox/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"kind":"body","prompt":"a cyberpunk ninja girl with a neon jacket"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Suivez la tâche
L’appel répond tout de suite avec un id de tâche. Interrogez la tâche jusqu’à ce qu’elle se termine :
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- En attente d’un worker
- running
- En cours de création
- succeeded
- Terminé : outputs[].url contient les fichiers
- failed
- Échec : rien n’est facturé
Erreurs et solutions
401Clé manquante ou incorrecte
Envoyez l’en-tête Authorization: Bearer avec une clé de la console.
402Solde insuffisant
Ajoutez du crédit dans Facturation, puis renvoyez le même appel.
400Une valeur est refusée
Lisez error.message : il nomme le champ. Utilisez une valeur du tableau des paramètres.
429Trop de requêtes
Attendez quelques secondes et réessayez, un peu plus longtemps après chaque 429.
Corps d'avatar Roblox : questions
Combien coûte Corps d'avatar Roblox ?
Vous payez par exécution, au prix affiché avant de lancer.
Comment l’appeler depuis mon code ?
Envoyez POST https://api.opennan.com/v1/roblox/models avec votre clé d’API. La réponse est un id de tâche : interrogez https://api.opennan.com/v1/tasks/{id} jusqu’à la réussite ou l’échec de la tâche.
Mon agent IA peut-il l’utiliser ?
Oui. Indiquez https://api.opennan.com/llms.txt à votre agent : il explique cet endpoint et tous les autres.
Que se passe-t-il si une exécution échoue ?
Une exécution en échec n’est pas facturée. Vous ne payez que les résultats.
Quels fichiers est-ce que je reçois ?
Du GLB pour le web, les moteurs de jeu et les apps 3D, du FBX pour Roblox Studio, Unity, Unreal et Blender, et une miniature. Les exécutions riggées ajoutent des clips de marche et de course.