Skip to main content
POST
Aviso de compatibilidade de nome de modelo: esta interface também é compatível com o alias gpt-image-2-ext, que é equivalente a gpt-image-2; ambos podem ser usados de forma intercambiável e produzem o mesmo resultado.

Autorizações

string
obrigatório
Todos os endpoints requerem autenticação por Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIInclua-a no cabeçalho da requisição:

Body

string
padrão:"gpt-image-2"
obrigatório
Nome do modelo de geração de imagensFixo em gpt-image-2 (alias compatível gpt-image-2-ext)
Para compatibilidade com chamadas de versões anteriores, o alias gpt-image-2-ext (correspondente a gpt-image-2) continua podendo ser usado normalmente.
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para a geração da imagem
  • Suporta inglês e chinês, descrições detalhadas são recomendadas
  • Moderação de conteúdo / revisão de segurança antes do envio — violações são rejeitadas imediatamente
integer
padrão:"1"
Número de imagens a serem geradasValor: 1
Deve ser um número puro (ex.: 1), não envolva em aspas
string
padrão:"1:1"
Proporção da imagemProporções suportadas, além de auto para deixar o servidor escolher uma proporção adequada automaticamente:Dimensões em pixels também podem ser passadas diretamente, como 1881x836 / 887x1774.
Quando size é definido como auto, a proporção padrão é 1:1.
string
padrão:"1k"
Nível de resolução de saídaOpções: 1k / 2k / 4kMapeamento size × resolution → pixels reais:
O 4K suporta as 15 proporções listadas acima; você também pode passar as dimensões em pixels da tabela diretamente via size.
array
Array de imagens de referência (campo padrão OpenAI). Alterna para o modo imagem para imagem quando fornecido.
Outros campos padrão da OpenAI (response_format, style) não são suportados e serão ignorados. Os resultados das tarefas retornam apenas url — faça você mesmo o download e converta para base64 se necessário.
boolean
padrão:"false"
Se deve recorrer ao canal oficial como fallback
  • false: Não usar (padrão)
  • true: Usar o canal oficial

Exemplos de uso

Texto para imagem (requisição mínima)
Texto para imagem (com proporção + 2K)
Texto para imagem (saída em 4K)
Texto para imagem (múltiplas)
Imagem para imagem (referência = URL)
Imagem para imagem (referência = base64)
Imagem para imagem (fusão multi-referência, URL + base64 combinados)

Response

integer
Código de status da resposta
array
Array de dados da resposta

Consulta de resultados da tarefa

Após o envio bem-sucedido, um task_id é retornado. Consulte o status da tarefa via GET /v1/tasks/{task_id}, veja API de consulta de tarefas para mais detalhes.

Exemplo de resposta de sucesso

Acesso à imagem: data.result.images[0].url[0]

Status da tarefa