Skip to main content
POST

Modelos suportados

Autorizações

string
obrigatório
Todas as requisições à API 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 APIAdicione o seguinte aos cabeçalhos da sua requisição:

Body

string
obrigatório
Nome do modelo
  • gpt-image-1-official - Estabilidade prioritária, adequado para geração de imagens em geral
  • gpt-image-1.5-official - Nova versão, adequada para maior qualidade e edição complexa
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 geração da imagem, suporta tanto chinês quanto inglês
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
  • 1:1 - Quadrado (padrão)
  • 3:2 - Paisagem
  • 2:3 - Retrato
integer
padrão:"1"
Número de imagens a serem geradasIntervalo: 1-4
  • Valores ≤ 0 serão tratados como 1
  • Valores > 4 serão tratados como 4
Aviso: Deve ser um número puro (ex.: 1), não use aspas, caso contrário ocorrerá um erro
string
padrão:"auto"
Qualidade da imagem
  • auto - Seleção automática de qualidade (padrão)
  • low - Mais rápido, mais econômico
  • medium - Equilíbrio entre qualidade e custo
  • high - Qualidade mais alta, custo mais alto
string
padrão:"auto"
Modo de fundo
  • auto - Fundo automático (padrão)
  • opaque - Fundo opaco
  • transparent - Fundo transparente, recomendado com o formato de saída png
background: transparent não pode ser usado simultaneamente com output_format: jpeg
string
padrão:"auto"
Nível de moderação
  • auto - Nível de moderação padrão
  • low - Moderação mais permissiva
string
padrão:"png"
Formato de saída
  • png - Formato padrão, adequado para fundos transparentes
  • jpeg - Tamanho de arquivo menor, adequado para saída de imagens em geral
background: transparent não pode ser usado simultaneamente com output_format: jpeg
integer
Nível de compressão de saída, intervalo 0-100
  • Recomendado apenas para jpeg
  • Não recomendado para png
array
Array de URLs de imagens de referência, ativa o modo imagem para imagem quando fornecidoLimite: Até 15 imagens de referência
string
URL da imagem de máscara para inpainting
  • Deve ser usado em conjunto com image_urls
  • Será submetida via a API oficial de edição
  1. Antes de fazer o upload da imagem de máscara, confirme que o canal Alpha da imagem está como “Sim”.
  2. O tamanho da imagem de máscara deve coincidir com a primeira imagem de referência.

Referência de tamanhos

As proporções são usadas externamente; o sistema as mapeia automaticamente para as dimensões oficiais internamente.

Exemplos de uso

Texto para imagem (mínimo)
Texto para imagem (parâmetros completos)
Imagem para imagem (referência única)
Imagem para imagem (fusão de múltiplas referências)
Múltiplas imagens (n > 1)

Response

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

Observações

  1. Processamento assíncrono: Após o envio, um task_id é retornado. Faça polling em /v1/tasks/{task_id} para obter os resultados
  2. Escolha do modelo: Use gpt-image-1-official para geração de imagens em geral; use gpt-image-1.5-official para edição de alta qualidade e tarefas complexas de imagem para imagem
  3. Requisitos da URL da imagem: Para imagem para imagem, use URLs de imagens publicamente acessíveis e estáveis
  4. Cobrança: Cobrado por imagem gerada com sucesso; sem cobrança em caso de falha