Personajes 3D
DisponibleEnvía una imagen o describe un personaje. Recibe un modelo 3D con rig en GLB y FBX, con clips de caminar y correr. Una imagen que no está en pose en T se vuelve a dibujar en una primero.
Personajes 3D
Entrada
imageUn enlace https público a la imagen.
knight-tpose-7beb62e2.png
qualityEstándar o alto detalle.engineQué motor 3D lo hace (solo se envía cuando hay más de uno).animationsClips de animación hechos para el modelo con rig.Sin coste extraPara el mejor personaje: una figura, de frente, boca cerrada y neutra, fondo liso y nada en las manos.
3D estándar3D estándar
- 1. Revisión de la pose en TNo está en este resultado.
- 2. Modelo 3DModelo con texturas creado.
- 3. RigCon rig y 2 clips.
Cada paso por separado
La pipeline de arriba encadena estas herramientas. Llama a cualquiera por separado: cada una tiene su propio endpoint, precio y página.
Cómo funciona la pipeline 3D
Los mismos pasos que usamos para crear personajes para nuestros propios juegos.
- 01Revisión de la pose en TUn vistazo rápido a tu imagen. Si no es una pose en T frontal estricta con la boca cerrada y neutra sobre un fondo liso, se vuelve a dibujar así, con el mismo personaje. Los brazos extendidos mantienen las manos limpias.
- 02Modelo 3DUna malla con texturas y lista para juegos, hecha a partir de la imagen en pose en T, con materiales PBR y sin la iluminación horneada. Personajes y objetos tienen su propio límite de triángulos.
- 03RigUn esqueleto ajustado al personaje para que pueda moverse, con clips de caminar y correr si los pides. Recibes FBX para motores de juego y GLB para la web.
Llama a Personajes 3D desde tu código
Cada herramienta 3D es su propio endpoint. Cada llamada devuelve una tarea: consúltala hasta que termine. Una ejecución fallida no se cobra.
https:/ / api.opennan.com/ v1/ 3d/ characters- POST
/Cualquier imagen de personaje a una pose en T frontal.v1/ 3d/ tpose - POST
/Imagen o prompt a un modelo con texturas.v1/ 3d/ models - POST
/Modelo humanoide a FBX y GLB con rig.v1/ 3d/ rig - GET
/Progreso y archivos.v1/ tasks/ {id} - GET
/Motores 3D y niveles de calidad, con preciosv1/ models? category= 3d
Consigue una clave de API
Crea una clave en la consola. Usa el mismo saldo que el playground.
Crear una claveEnvía tu primera solicitud
La misma solicitud que envía el playground. Pon tu clave en OPENNAN_KEY.
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"Consulta la tarea
La llamada responde al instante con un id de tarea. Consulta la tarea hasta que termine:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Esperando un worker
- running
- En proceso
- succeeded
- Listo: outputs[].url contiene los archivos
- failed
- Falló: no se cobra
Errores y cómo resolverlos
401Falta la clave o es incorrecta
Envía la cabecera Authorization: Bearer con una clave de la consola.
402Saldo insuficiente
Añade saldo en Facturación y vuelve a enviar la misma llamada.
400Un valor no se acepta
Lee error.message: indica el campo. Usa un valor de la tabla de parámetros.
429Demasiadas solicitudes
Espera unos segundos y vuelve a intentarlo, esperando más tras cada 429.
Añade Opennan a tu app de IA
Una sola instalación le da a tu IA todas las herramientas de Opennan: vídeo, imágenes, chat, voz, música, efectos de sonido, 3D, subtítulos y doblaje. Elige tu app y sigue los pasos.
https:/ / api.opennan.com/ v1/ mcpFunciona en Codex CLI, la app de Codex y la extensión de Codex para el IDE: comparten ~/.codex/config.toml. Si la app o el IDE no ven OPENNAN_KEY, usa la opción de config.toml con tu clave. Codex pide permiso antes de cada herramienta: apruébalo para seguir.
Consigue una clave de API
Crea una clave en la consola. Empieza por sk- y usa el mismo saldo que la web.
Crear una claveGuarda tu clave como 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-..."Instala el plugin de Opennan: el servidor y una skill que enseña a tu IA a elegir modelos, confirmar precios y esperar los resultados
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanO añade solo el servidor
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYO añade esto a ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Comprueba que opennan aparece en la lista
codex mcp listReinicia Codex y pide lo que quieras
“Haz un vídeo de 5 segundos de lluvia en una calle de neón, una canción que lo acompañe y una imagen de póster.”
Cambia sk-... por tu propia clave y mantenla en privado: quien la tenga puede gastar tu saldo. Tu app puede listar las herramientas sin clave; para crear algo necesitas una.
Úsalo desde un agente de IA
Añade el servidor MCP de Opennan a tu agente y llama a esta herramienta.
- Herramienta
- generate_3d_character
- Argumentos de ejemplo
{ "prompt": "a knight in silver armour with a blue cape", "quality": "standard", "animations": true, "engine": "opennan-3d-studio" }
Personajes 3D: preguntas
¿Cuánto cuesta Personajes 3D?
Pagas por ejecución, al precio que ves antes de empezar.
¿Cómo lo llamo desde mi código?
Envía POST https://api.opennan.com/v1/3d/characters con tu clave de API. Responde con un id de tarea: consulta https://api.opennan.com/v1/tasks/{id} hasta que la tarea termine bien o falle.
¿Puede usarlo mi agente de IA?
Sí. Añade el servidor MCP https://api.opennan.com/v1/mcp y llama a la herramienta generate_3d_character, o indícale a tu agente https://api.opennan.com/llms.txt.
¿Qué pasa si una ejecución falla?
Una ejecución fallida no se cobra. Solo pagas por resultados.
¿Por qué la imagen necesita una pose en T?
Los brazos rectos y extendidos separan las manos del cuerpo, así el modelo tiene manos limpias y el rig se dobla en las articulaciones correctas. Con los brazos abajo o en pose en A, las manos suelen fundirse con la ropa, y una sonrisa queda pintada en la textura. Por eso una imagen que no está en pose en T se vuelve a dibujar primero, con el mismo personaje.
¿Qué archivos recibo?
GLB para la web, motores de juego y apps 3D, FBX para Roblox Studio, Unity, Unreal y Blender, y una miniatura. Las ejecuciones con rig añaden clips de caminar y correr.


