Configuração da API de Imagens da OpenAI
A geração de imagens não utiliza a interface de chat convencional. Mesmo que um provedor de IA ofereça suporte ao modelo de texto, isso não significa necessariamente que suporte a interface de imagens da OpenAI. Verifique com o provedor se há menção explícita a 'Images API', 'geração de imagens' ou ao modelo correspondente antes de configurar.
Informações oficiais Downloads e documentações estão sujeitos ao site oficial.
Primeiro, confirme se o provedor suporta a interface de imagens
| O que verificar | Como consultar | Por que |
|---|---|---|
| Tipo de interface | Se o painel ou a documentação menciona explicitamente Images API, geração de imagens, edição de imagens | Apenas indicar compatibilidade com a interface de chat da OpenAI não significa que a interface de imagens também esteja disponível |
| Permissões do modelo | Se a lista de modelos inclui modelos de imagem e se a conta ou chave (Key) tem permissão | Os modelos de imagem costumam ser cobrados e ativados separadamente dos modelos de texto |
| Caminho da requisição | Se o provedor forneceu exemplos para a interface de imagens | Alguns provedores apenas fazem proxy da interface de chat; requisitar diretamente o caminho de imagens resultará em erro 404 |
| Preço | As imagens são cobradas por unidade, tamanho ou qualidade | Teste com poucas requisições antes de gerar em lote para evitar cobranças elevadas inesperadas |
Diferenças em relação à interface de chat
| Tipo | Interfaces comuns | Preparação necessária |
|---|---|---|
| Chat de texto | /v1/chat/completions ou Responses | Chave (Key), Base URL, nome do modelo, conteúdo da mensagem |
| Geração de imagens | /v1/images/generations | Chave (Key), modelo de imagem, prompt, tamanho, formato de saída |
| Edição de imagens | Interface de edição de imagens | Além do prompt, você também precisa enviar a imagem original ou a máscara (mask) |
Como preencher os campos
| Item de configuração | Como preencher |
|---|---|
| Endpoint | https://api.openai.com/v1/images/generations |
| Model | Exemplo oficial disponível: <code>gpt-image-2</code>; para serviços de provedores, preencha de acordo com a lista do provedor |
| Prompt | Qual imagem você deseja gerar |
| Size | Tamanho da imagem |
| Format | URL ou base64 |
Se estiver usando um provedor, substitua o domínio oficial pelo endereço da API de imagens fornecido pelo provedor; se o provedor não especificou suporte à interface de imagens, não assuma que ela esteja disponível. Se a Base URL inclui /v1 ou não, siga os exemplos da documentação/painel do provedor e não tente adivinhar.
Exemplo de requisição
Exemplo de geração de imagem da OpenAI
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'O custo da interface de imagens geralmente é diferente da interface de texto. Verifique o preço antes de gerar em lote.
| Erro | Causas comuns | Soluções |
|---|---|---|
| 404 / endpoint not found | O provedor não possui uma interface de proxy de imagens, ou o caminho tem barras a mais/a menos em /v1 | Acesse o painel para encontrar um exemplo dedicado da interface de imagens; não use diretamente a interface de chat |
| model not found | O nome do modelo de imagem não está na lista atual do provedor | Copie o ID/nome original do modelo de imagem, não o do modelo de texto |
| unsupported content type | A interface de edição de imagens requer o upload de arquivos; você não pode enviar apenas JSON | Primeiro confirme se você está chamando a interface de geração ou a de edição |