Opennan

Consistency reference

Ao vivo

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.

Saída

Exemplo
Resultado de exemploMade with these inputsConsistency reference

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

Chame Consistency reference pelo seu 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. Pegue uma chave de API

    Crie uma chave no console. Ela usa o mesmo saldo do playground.

    Criar uma chave

  2. Envie sua primeira requisição

    A mesma requisição que o playground envia. Defina OPENNAN_KEY com sua chave.

    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. Consulte a tarefa

    A chamada responde na hora com um id de tarefa. Consulte a tarefa até ela terminar:

    GEThttps://api.opennan.com/v1/tasks/{id}
    queued
    Esperando um worker
    running
    Em produção
    succeeded
    Pronto: outputs[].url traz os arquivos
    failed
    Falhou: nada é cobrado

Erros e como resolver

  • 401Chave ausente ou errada

    Envie o cabeçalho Authorization: Bearer com uma chave do console.

  • 402Saldo insuficiente

    Adicione crédito em Faturamento e envie a mesma chamada de novo.

  • 400Um valor não é aceito

    Leia error.message: ele indica o campo. Use um valor da tabela de parâmetros.

  • 429Requisições demais

    Aguarde alguns segundos e tente de novo, esperando mais após cada 429.

Adicione a Opennan ao seu app de IA

Uma instalação dá à sua IA todas as ferramentas da Opennan: vídeo, imagens, chat, voz, música, efeitos sonoros, 3D, legendas e dublagem. Escolha seu app e siga os passos.

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

Funciona no Codex CLI, no app do Codex e na extensão do Codex para IDE: todos usam ~/.codex/config.toml. Se o app ou a IDE não enxergar OPENNAN_KEY, use a opção config.toml com sua chave. O Codex pede aprovação antes de cada ferramenta: aprove para seguir.

  1. Pegue uma chave de API

    Crie uma chave no console. Ela começa com sk- e usa o mesmo saldo do site.

    Criar uma chave

  2. Salve sua chave 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. Instale o plugin da Opennan: o servidor e uma skill que ensina sua IA a escolher modelos, confirmar preços e esperar os resultados

    codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan

  4. Ou adicione só o servidor

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

  5. Ou adicione isto a ~/.codex/config.toml

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

  6. Confira se opennan aparece na lista

    codex mcp list

  7. Reinicie o Codex e peça o que quiser

    “Faça um vídeo de 5 segundos de chuva numa rua de neon, uma música para acompanhar e uma imagem de pôster.”

Troque sk-... pela sua chave e mantenha-a em segredo: quem tiver a chave pode gastar seu saldo. Seu app lista as ferramentas sem chave; para criar algo, você precisa de uma.

Use a partir de um agente de IA

Adicione o servidor MCP da Opennan ao seu agente e chame esta ferramenta.

Ferramenta
generate_reference_image
Argumentos de exemplo
{
  "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: perguntas

Quanto custa Consistency reference?

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

Como chamo pelo meu código?

Envie POST https://api.opennan.com/v1/consistency/references com sua chave de API. A resposta é um id de tarefa: consulte https://api.opennan.com/v1/tasks/{id} até a tarefa concluir ou falhar.

Meu agente de IA pode usar?

Sim. Adicione o servidor MCP https://api.opennan.com/v1/mcp e chame a ferramenta generate_reference_image, ou aponte seu agente para https://api.opennan.com/llms.txt.

O que acontece se uma execução falhar?

Uma execução com falha não é cobrada. Você paga só pelos 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.

Usamos apenas os cookies de que o site precisa, como seu idioma e um código de indicação. Sem anúncios. Contamos as visitas com uma análise sem cookies. Veja nossa Política de Cookies para mais detalhes.