Objet 3D Roblox
DisponibleDécrivez-le ou importez une image. Recevez un objet 3D à la taille Roblox (FBX + GLB) à importer dans Roblox Studio. Payé par modèle sur votre solde.
Objet 3D Roblox
Entrée
Chapeaux, animaux de compagnie, armes et accessoires, sous la limite de 4 000 triangles de Roblox pour les accessoires.
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 Objet 3D 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":"item","prompt":"a wooden treasure chest with gold trim"}' # 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.
Objet 3D Roblox : questions
Combien coûte Objet 3D 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.