Opennan

Consistency reference

Disponible

Name a character, a location or an object and describe it. Get one clean reference image to keep it looking the same across every shot you make.

From $0.1313 per imageFailed runs are not charged.

Consistency reference

Entrada

What to draw
A wide, empty establishing view of the place.
163 / 500
For example: anime, film noir, warm 3D animation.

$0.1963 per image.

These tools need an API key with the api:opennan scope: paste one under Use API key to run them.

Salida

Ejemplo
Resultado de ejemploMade with these inputsConsistency reference

Cómo funciona

  1. 01Describe itA name, a look and a style; a photo for a character if you have one.
  2. 02We draw the referenceA portrait, an empty establishing view or a product shot.
  3. 03Reuse itSend it as a reference image with every shot.

Llama a Consistency reference desde tu código

One endpoint and one key, on the same balance as the playground. The request below is the example's own.

POSThttps://api.opennan.com/v1/consistency/references

  1. Consigue una clave de API

    Crea una clave en la consola. Usa el mismo saldo que el playground.

    Crear una clave

  2. Envía tu primera solicitud

    La misma solicitud que envía el playground. Pon tu clave en OPENNAN_KEY.

    curl https://api.opennan.com/v1/consistency/references \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"location","name":"Snowy log cabin","description":"A small wooden log cabin on a snowy mountain slope at dusk, warm light glowing in the windows, smoke from a stone chimney, pine trees and snow-covered peaks behind","style":"warm 3D animation"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

  3. 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.

Servidor MCPhttps://api.opennan.com/v1/mcp

Funciona 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.

  1. Consigue una clave de API

    Crea una clave en la consola. Empieza por sk- y usa el mismo saldo que la web.

    Crear una clave

  2. Guarda 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-..."

  3. 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@opennan

  4. O añade solo el servidor

    codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

  5. O añade esto a ~/.codex/config.toml

    [mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

  6. Comprueba que opennan aparece en la lista

    codex mcp list

  7. Reinicia 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_reference_image
Argumentos de ejemplo
{
  "kind": "location",
  "name": "Snowy log cabin",
  "description": "A small wooden log cabin on a snowy mountain slope at dusk, warm light glowing in the windows, smoke from a stone chimney, pine trees and snow-covered peaks behind",
  "style": "warm 3D animation"
}

Consistency reference: preguntas

¿Cuánto cuesta Consistency reference?

From $0.1313 per image. The Run button shows the exact price for your input before you start.

¿Cómo lo llamo desde mi código?

Envía POST https://api.opennan.com/v1/consistency/references 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_reference_image, 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.

Which API key do I need?

A key with the api:opennan scope. A full api key does not include it: create one with that scope in the console, then use it here under Use API key or in your code.

Solo usamos las cookies que el sitio necesita, como las de idioma y código de referido. Sin publicidad. Contamos las visitas con una analítica sin cookies. Consulta nuestra Política de cookies para más detalles.