Imagen a modelo 3D
DisponibleEntra una imagen o un prompt y sale un modelo 3D con texturas: GLB, FBX y una miniatura. Crea un personaje listo para un rig o un objeto.
Imagen a modelo 3D
Entrada
promptQué crear, con palabras.kindcharacter o prop.Un objeto como un arma, un sombrero o un mueble. Sin rig.qualityEstándar o alto detalle.engineQué motor 3D lo hace (solo se envía cuando hay más de uno).3D estándar × Objeto3D estándar × Objeto
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.
Ejecuta los tres pasos en una sola llamada:Personajes 3D
Llama a Imagen a modelo 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/ models- POST
/Imagen o prompt a un personaje con rig.v1/ 3d/ characters - POST
/Cualquier imagen de personaje a una pose en T frontal.v1/ 3d/ tpose - 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/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"a wooden treasure chest with gold trim","kind":"prop","quality":"standard","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_model
- Argumentos de ejemplo
{ "prompt": "a wooden treasure chest with gold trim", "kind": "prop", "quality": "standard", "engine": "opennan-3d-studio" }
Imagen a modelo 3D: preguntas
¿Cuánto cuesta Imagen a modelo 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/models 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_model, 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.