Resposta rápida
- O ponto de entrada é POST /v1/images/generations; defina model=gpt-image-2 no corpo da requisição.
- Aceita geração por prompt e imagens de referência por URL em reference_images para geração guiada ou edição.
- As imagens de referência aceitam apenas URL, então os arquivos locais precisam ser enviados primeiro em vez de passar base64 diretamente.
- O endpoint funciona com tarefas assíncronas: retorna um id de tarefa e depois o resultado é consultado no endpoint de status da tarefa de imagem.
- O preço público oficial fica em torno de $0.22 / $0.50 / $1.30 por imagem em 1K / 2K / 4K; a ToAPIs mostra atualmente $0.015 / $0.020 / $0.025 por imagem na página comparativa, com a cobrança final baseada no preço da sua conta.
- Com a tarifa 1K da ToAPIs de $0.015 por imagem, uma recarga de $10 equivale a cerca de 600 imagens 1K adicionais; com a tarifa 4K de $0.025 por imagem, a cerca de 400 imagens 4K.
Parâmetros principais
- model | string | obrigatório | gpt-image-2 | - | Use gpt-image-2 como identificador exato do modelo.
- prompt | string | obrigatório | - | - | Prompt principal para gerar ou editar imagens.
- size | string | opcional | 1:1 | 1K: 1:1 | 3:2 | 2:3; 2K: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9 | 9:21; 4K: 4:3 | 3:4 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9 | 9:21 | Proporção de saída; os valores aceitos dependem da resolução selecionada.
- resolution | string | opcional | 1K | 1K | 2K | 4K | Nível de resolução de saída; deve corresponder a uma combinação de size aceita.
- reference_images | string[] | opcional | - | Matriz de URL | Matriz de URLs de imagens de referência para geração guiada ou edição. As imagens locais precisam ser enviadas antes; base64 direto não é aceito.
- image_urls | string[] | opcional | - | Matriz de URL (campo de compatibilidade) | Campo de compatibilidade; chamadas antigas continuam funcionando, mas em novas integrações é melhor usar reference_images.










