Pular para o conteúdo principal
POST
Criar imagem
Cria uma ou mais imagens a partir de um prompt de texto.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
prompt
string
obrigatório
models
string[]

Modelos de fallback opcionais e ordenados, tentados depois de model. model é obrigatório e é sempre o modelo principal. Quando uma tentativa falha com 429, 500, 502, 503 ou 504, a próxima entrada é tentada; os demais erros são retornados sem alteração. Aceita até 25 IDs de modelo ou predefinições; duplicatas e entradas iguais a model são ignoradas. Cada tentativa é validada, registrada e cobrada como uma solicitação separada, e o campo model da resposta e o rastreamento de roteamento mostram o modelo que atendeu a solicitação. Solicitações em streaming só recorrem a um fallback antes do primeiro byte, e trabalhos de vídeo e música apenas no envio. Solicitações de batch, realtime e council rejeitam models. Fallbacks definidos em uma rota dinâmica têm precedência, e phaseo/auto não pode ser combinado com models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemplo:
size
string
resolution
string
n
integer
Intervalo obrigatório: 1 <= x <= 10
quality
string
stream
boolean
partial_images
integer
Intervalo obrigatório: 0 <= x <= 3
output_format
enum<string>

Formato de saída. gif e svg exigem um modelo GPT Image 2.6 e não aceitam stream nem partial_images. svg também exige svg.model e n=1.

Opções disponíveis:
png,
jpeg,
webp,
gif,
svg
output_compression
integer
Intervalo obrigatório: 0 <= x <= 100
background
enum<string>
Opções disponíveis:
transparent,
opaque,
auto
moderation
enum<string>
Opções disponíveis:
auto,
low
complexity
enum<string>
Opções disponíveis:
low,
medium,
high
frame_count
integer
Intervalo obrigatório: 2 <= x <= 64
frame_duration_ms
integer
Intervalo obrigatório: 20 <= x <= 2000
svg
object

Obrigatório quando output_format é svg. svg.model é o modelo de texto da OpenAI que escreve o SVG a partir da imagem de referência. Os tokens dele são cobrados pelos preços de texto desse modelo, com tokens de raciocínio contados como saída, além do custo da imagem.

response_format
string
style
string
user
string
provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

Resposta

Resposta de imagem

created
integer
data
object[]
svg_usage
object
Última modificação em 16 de novembro de 2026