Personnages 3D
DisponibleEnvoyez une image ou décrivez un personnage. Recevez un modèle 3D riggé en GLB et FBX, avec des clips de marche et de course. Une image qui n'est pas en T-pose est d'abord redessinée en T-pose.
Personnages 3D
Entrée
imageUn lien https public vers l'image.
knight-tpose-7beb62e2.png
qualityStandard ou haute définition.engineLe moteur 3D qui s'en charge (envoyé seulement s'il y en a plusieurs).animationsDes clips d'animation créés pour le modèle riggé.Sans surcoûtPour le meilleur personnage : une seule figure, de face, bouche fermée et neutre, fond uni, rien dans les mains.
3D standard3D standard
- 1. Vérification de la T-poseAbsent de ce résultat.
- 2. Modèle 3DModèle texturé créé.
- 3. RigRiggé, avec 2 clips.
Chaque étape séparément
Le pipeline ci-dessus enchaîne ces outils. Appelez-les un par un : chacun a son endpoint, son prix et sa page.
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.
Appelez Personnages 3D 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:/ / api.opennan.com/ v1/ 3d/ characters- POST
/N'importe quelle image de personnage en T-pose de face.v1/ 3d/ tpose - POST
/Image ou prompt vers un modèle texturé.v1/ 3d/ models - POST
/Modèle humanoïde vers FBX et GLB riggés.v1/ 3d/ rig - 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/3d/characters \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"a knight in silver armour with a blue cape","quality":"standard","animations":true,"engine":"opennan-3d-studio"}' # 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.
Ajoutez Opennan à votre app d’IA
Une seule installation donne à votre IA tous les outils Opennan : vidéo, images, chat, voix, musique, effets sonores, 3D, sous-titres et doublage. Choisissez votre app et suivez les étapes.
https:/ / api.opennan.com/ v1/ mcpFonctionne dans Codex CLI, l’app Codex et l’extension Codex pour IDE : elles partagent ~/.codex/config.toml. Si l’app ou l’IDE ne voit pas OPENNAN_KEY, utilisez l’option config.toml avec votre clé. Codex demande avant chaque appel d’outil : approuvez pour continuer.
Obtenez une clé API
Créez une clé dans la console. Elle commence par sk- et utilise le même solde que le site.
Créer une cléEnregistrez votre clé sous OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Installez le plugin Opennan : le serveur et un skill qui apprend à votre IA à choisir les modèles, confirmer les prix et attendre les résultats
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOu ajoutez seulement le serveur
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOu ajoutez ceci à ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Vérifiez que opennan est dans la liste
codex mcp listRedémarrez Codex, puis demandez ce que vous voulez
“Fais une vidéo de 5 secondes de pluie dans une rue au néon, une chanson pour l’accompagner et une affiche.”
Remplacez sk-... par votre propre clé et gardez-la privée : toute personne qui l’a peut dépenser votre solde. Votre app peut lister les outils sans clé ; il en faut une pour créer quoi que ce soit.
Utilisez-le depuis un agent IA
Ajoutez le serveur MCP d’Opennan à votre agent et appelez cet outil.
- Outil
- generate_3d_character
- Arguments d’exemple
{ "prompt": "a knight in silver armour with a blue cape", "quality": "standard", "animations": true, "engine": "opennan-3d-studio" }
Personnages 3D : questions
Combien coûte Personnages 3D ?
Vous payez par exécution, au prix affiché avant de lancer.
Comment l’appeler depuis mon code ?
Envoyez POST https://api.opennan.com/v1/3d/characters 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. Ajoutez le serveur MCP https://api.opennan.com/v1/mcp et appelez l’outil generate_3d_character, ou indiquez https://api.opennan.com/llms.txt à votre agent.
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.
Pourquoi l'image doit-elle être en T-pose ?
Les bras tendus à l'horizontale éloignent les mains du corps : le modèle a des mains nettes et le rig plie aux bonnes articulations. Bras le long du corps ou en A-pose, les mains se fondent souvent dans les vêtements, et un sourire se retrouve peint dans la texture. C'est pourquoi une image qui n'est pas en T-pose est d'abord redessinée, avec le même personnage.
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.


