API de geração de imagens
Ao vivoGere e edite imagens a partir de um prompt ou de uma imagem de referência.
Compare modelos de API de geração de imagens
Todos os modelos deste endpoint, com preços ao vivo. Teste um no playground ou abra a página dele.
- Flux SchnellBlack Forest Labs$0.0039 por imagemMais barato
- Z Image TurboAlibaba$0.00507 por imagem$0.015 por imagem-66%
- GPT Image 1.5OpenAI$0.026 por imagem$0.034 por imagem-23%medium
- Nano BananaGoogle$0.026 por imagem$0.039 por imagem-33%Melhor custo-benefício
- Seedream 4.0ByteDance$0.02925 por imagemAbaixo do preço do fabricante
- Flux KontextBlack Forest Labs$0.0325 por imagem$0.04 por imagem-18%
- GPT Image 2OpenAI$0.039 por imagem$0.053 por imagem-26%medium
- Nano Banana 2Google$0.04589 por imagem$0.067 por imagem-31%Melhor
- Nano Banana 2.1Google$0.0585 por imagem$0.113 por imagem-48%
- Nano Banana ProGoogle$0.05928 por imagem$0.134 por imagem-55%
- Flux DevBlack Forest Labs$0.065 por imagem
Chame API de geração de imagens pelo seu código
Um endpoint para todos os modelos acima. Mude o campo model para trocar.
https:/- GET
/Todos os modelos deste endpoint, com preçosv1/ models? category= image
Pegue uma chave de API
Crie uma chave no console. Ela usa o mesmo saldo do playground.
Criar uma chaveEnvie sua primeira requisição
A mesma requisição que o playground envia. Defina OPENNAN_KEY com sua chave.
curl https://api.opennan.com/v1/images/generations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"flux-schnell","prompt":"Um bule de vidro em um parapeito ensolarado, luz suave da manhã, foto 35 mm","aspect_ratio":"1:1"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"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
Parâmetros
Gerados a partir do catálogo ao vivo: todo valor listado aqui é aceito pela API.
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.
https:/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.
Pegue uma chave de API
Crie uma chave no console. Ela começa com sk- e usa o mesmo saldo do site.
Criar uma chaveSalve 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-..."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@opennanOu adicione só o servidor
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOu adicione isto a ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Confira se opennan aparece na lista
codex mcp listReinicie 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_image
- Argumentos de exemplo
{ "model": "flux-schnell", "prompt": "Um bule de vidro em um parapeito ensolarado, luz suave da manhã, foto 35 mm" }
API de geração de imagens: perguntas
Quanto custa API de geração de imagens?
A partir de $0.0039 por imagem com Flux Schnell, o mais barato de 11 modelos aqui. Você vê o preço antes de rodar.
Como chamo pelo meu código?
Envie POST https://api.opennan.com/v1/images/generations 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.
Posso trocar de modelo sem mudar meu código?
Sim. Mude o campo model e mantenha o resto da requisição, a mesma chave e o mesmo saldo.
Meu agente de IA pode usar?
Sim. Adicione o servidor MCP https://api.opennan.com/v1/mcp e chame a ferramenta generate_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.