Skip to main content
POST

Autenticação e cabeçalhos

string
obrigatório
Os endpoints de geração e consulta de tarefas usam uma API Key da plataforma para autenticação Bearer Token. Obtenha uma chave na página de gerenciamento de API Keys.
Para consultar a tarefa, use uma API Key pertencente ao mesmo usuário da plataforma.
string
obrigatório
Use application/json no envio. A geração a partir de texto e de imagens utiliza um corpo de solicitação JSON.

Seleção da versão

Parâmetros da solicitação

string
obrigatório
Valor fixo: gpt-image-2.5-ext.
string
padrão:"flare"
Versão do modelo. Opções: flare, sunburst.
string
obrigatório
Prompt para geração ou edição de imagens. Não pode ficar vazio após a remoção dos espaços no início e no fim.Na geração a partir de imagens, descreva o que deve ser preservado e alterado nas referências.
string
padrão:"1K"
Nível de resolução da saída. Opções: 1K, 2K, 4K.
string
padrão:"auto"
Proporção da imagem de saída. Escolha auto ou uma das 10 proporções abaixo:1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.
integer
padrão:"1"
Quantidade de imagens a gerar por solicitação. Deve ser um número inteiro de 1 a 4.
string[]
Array com até 16 imagens de referência. Sem referências, a geração é feita a partir de texto; com referências, a partir de imagens. As referências não geram cobrança adicional.Formatos de entrada aceitos:
  • URLs de imagens acessíveis
  • Data URL: data:image/...;base64,...

Exemplos de uso

Os exemplos a seguir são corpos de solicitação JSON para POST /v1/images/generations. Use a autenticação e os cabeçalhos recomendados acima. Substitua os endereços de referência dos exemplos por URLs reais e acessíveis de imagens.

Geração a partir de texto

Geração a partir de imagens com Sunburst

Várias imagens de referência e de saída

Proporção automática e resolução 4K

Consultar resultados da tarefa

Use o ID da tarefa para chamar o endpoint de consulta de tarefas:

Tarefa concluída com sucesso

O ID da tarefa, os horários, as URLs e os valores abaixo ilustram apenas a estrutura da resposta. Não representam uma tarefa real nem preços efetivos.

Resposta

integer
Código de status da resposta. Um envio bem-sucedido no formato unificado retorna 200.
string
Identificador desta solicitação, usado para diagnóstico de problemas.
object
A tarefa assíncrona aceita.