oc_prompt, y después el backend de renderizado elegido crea la imagen. La solicitud devuelve un img_uuid asíncrono para sondeo o gestión por callback.API de OC Maker para generar personajes originales
Añade a tu producto un flujo de personajes en dos etapas a través de GoEnhance. Tu prompt guía a un modelo de lenguaje para producir datos estructurados de personaje con un
Crear una API Key
Convierte briefs de personaje en resultados estructurados y renderizados
Define los datos del personaje
Envía el prompt completo de la etapa de texto y define los campos JSON que necesita tu aplicación. La respuesta debe contener oc_prompt, mientras que campos como nombre del rol, apariencia, personalidad o historia previa pueden llegar junto con los datos de personaje generados.
Elige la vía de renderizado
Selecciona seedream o gpt-image-2 para la etapa de imagen y, si quieres, fija una proporción admitida. Un ratio a nivel de solicitud sobrescribe el oc_ratio del JSON generado, de modo que las decisiones de composición siguen en manos de tu aplicación.
Desarrolla siguiendo el contrato documentado de solicitud y resultado, en lugar de suponer que es un endpoint de imagen genérico.
Capacidades de la API de OC Maker
Generación en dos etapas
Una solicitud ejecuta primero la creación estructurada del personaje y después el renderizado de la imagen.
Contrato de prompt personalizado
Define las instrucciones de la etapa de texto y exige un JSON analizable con un campo <code>oc_prompt</code>.
Campos de personaje flexibles
Solicita campos adicionales como apariencia, personalidad, nombre del rol o historia previa para usarlos más adelante.
Elección del backend de renderizado
Ajusta <code>image_render_model</code> a <code>seedream</code> o <code>gpt-image-2</code>.
Proporciones de salida admitidas
Elige 1:1, 2:3, 3:2, 4:3, 3:4, 16:9 o 9:16; el valor predeterminado es 3:4.
Gestión asíncrona de resultados
Guarda <code>img_uuid</code> y luego consulta los detalles del trabajo o procesa un callback HTTPS público.
La tarifa documentada cubre la etapa del modelo de lenguaje y la de renderizado de imagen en una única solicitud facturada.
Precios de la API de OC Maker
1 token por solicitud
Cada solicitud de OC Maker cuesta 1 token de GoEnhance sumando ambas etapas de procesamiento.
$0.02 por solicitud
El equivalente en USD documentado actualmente es de $0.02 por una solicitud completa de OC Maker.
Reembolso de trabajos fallidos
La documentación indica que un fallo en cualquiera de las dos etapas hace fallar todo el trabajo y reembolsa los tokens.
Integra la API de OC Maker en cuatro pasos
1
1. Escribe el prompt de la etapa de texto
Indica al modelo que devuelva únicamente JSON analizable con
oc_prompt. Añade los campos de personaje que necesite tu aplicación. 2
2. Configura el renderizado
Envía por POST
model: oc-maker, tu prompt y el campo obligatorio image_render_model. De forma opcional, define la proporción de salida, el modelo de texto, el prompt de sistema o la URL de callback. 3
3. Sigue el trabajo y lee ambos resultados
Valida la respuesta del envío y guarda
data.img_uuid junto con tu propio registro de tarea. Consulta GET /api/v1/jobs/detail o procesa los callbacks hasta llegar al estado final; después lee el objeto estructurado de la entrada JSON y la URL del recurso de la entrada de imagen.Usa los datos estructurados de personaje y su imagen asociada cuando ambas salidas sirvan al mismo flujo de producto.
Casos de uso de la API de OC Maker
Creadores de personajes de rol
Genera un perfil de personaje y una imagen correspondiente para revisarlos dentro de una herramienta de rol.
Pipelines de concepto de videojuegos
Convierte briefs estructurados en registros de personaje iniciales e imágenes para un proceso conceptual dirigido por personas.
Herramientas de desarrollo narrativo
Crea campos de apariencia, personalidad e historia previa junto con una referencia visual para quienes escriben.
Flujos de creación de avatares
Recoge las decisiones del usuario, compón un prompt controlado y devuelve un retrato de personaje o un resultado de cuerpo entero.
Apps de prototipado creativo
Prueba ideas de personaje conservando datos estructurados que pueden alimentar interfaces de edición o aprobación.
Flujos de trabajo de recursos automatizados
Conecta la finalización de la tarea con moderación, almacenamiento, revisión y sistemas de contenido posteriores.
Respuestas a dudas habituales sobre precios, prompts, renderizado e integración.