Geração de imagens
Gere e edite imagens com a API de Imagens compatível com OpenAI: escolha um modelo do catálogo, envie uma requisição, leia o resultado e veja o preço.
Um único fluxo para todos os modelos de imagem disponíveis: escolha um modelo, envie uma requisição, leia a resposta e entenda o preço.
Todos os modelos, recursos e preços Índice da documentação para agentes de IA:https://oneprovider.dev/docs/llms.txt Escolha os modelos no catálogo compartilhado Este guia não fixa um modelo preferido. Os modelos de imagem disponíveis e os preços atuais deles ficam sempre na tabela de modelos compartilhada . Modelos de imagem disponíveis
gemini-3.1-flash-image Runnable - 0.5K
- US$ 0,045 / imagem
- 1K
- US$ 0,067 / imagem
- 2K
- US$ 0,101 / imagem
- 4K
- US$ 0,151 / imagem
gpt-image-2 Runnable - image input
- US$ 8,00 / 1M de tokens
- cached image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 30,00 / 1M de tokens
gpt-image-2.5 Runnable - image input
- US$ 8,00 / 1M de tokens
- cached image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 30,00 / 1M de tokens
gpt-image-2.5-flare Runnable - image input
- US$ 8,00 / 1M de tokens
- cached image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 30,00 / 1M de tokens
gpt-image-2.5-sunburst Runnable - image input
- US$ 8,00 / 1M de tokens
- cached image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 30,00 / 1M de tokens
gpt-image-2.6-flare Runnable - image input
- US$ 8,00 / 1M de tokens
- cached image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 30,00 / 1M de tokens
gpt-image-2.6-sunburst Runnable - image input
- US$ 8,00 / 1M de tokens
- cached image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 30,00 / 1M de tokens
grok-imagine Catálogo - per generation request
- US$ 0,02 / imagem
grok-imagine-image Runnable - per generated image
- US$ 0,02 / imagem
grok-imagine-image-2.0 Runnable - 1K
- US$ 0,06 / imagem
- 2K
- US$ 0,08 / imagem
grok-imagine-image-lite Runnable - per generated image
- US$ 0,025 / imagem
gemini-3-pro-image Catálogo - image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 120,00 / 1M de tokens
gemini-3-pro-image-preview Catálogo - image input
- US$ 2,00 / 1M de tokens
- generated image output
- US$ 120,00 / 1M de tokens
gemini-3.1-flash-image-preview Catálogo - image input
- US$ 0,50 / 1M de tokens
- generated image output
- US$ 60,00 / 1M de tokens
Requisição
POST /v1/images/generations. O caminho e os parâmetros opcionais vêm da especificação verificada do modelo escolhido.
curl -sS https://api.oneprovider.dev/v1/images/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A quiet observatory above the clouds",
"size": "1024x1024",
"quality": "low"
}'Os recursos variam por modelo
Tamanhos, níveis de qualidade, transparência, edição e formatos de resposta dependem do modelo. Não copie os parâmetros opcionais de um modelo para outro sem conferir se há suporte.
Resposta
Um transporte síncrono retorna os dados da imagem ou uma URL na hora. Um transporte assíncrono retorna o id de um job; consulte o caminho de status dele e depois baixe pelo caminho de conteúdo.
Preços
A tabela de modelos compartilhada separa cada taxa de token em uma coluna própria e mostra a cobrança por imagem ou outra mídia na coluna de mídia. Abrir os preços .
Respostas rápidas
Qual base URL devo usar?
O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .
Como me autentico?
Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .
Onde consigo uma chave?
Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .
O que significam 401, 404 e 429?
401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .
Por que os streams são cortados ou reiniciados?
VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.
Onde pergunto se isso não bastar?
Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .
Última atualização: 2026-11-08 Encontrou um erro? @Oneproviderhelpbot