gpt-image-2 API

Use o ID exato do modelo gpt-image-2. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídagpt-image-2POST /v1/images/generations

Parâmetros: size=1536x1024n=1

Prompt: A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.

Solicitação que produziu esta amostra

{
  "model": "gpt-image-2",
  "prompt": "A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.",
  "n": 1,
  "size": "1536x1024"
}

Autenticação e endpoint

Use uma chave de API Modelflare com https://modelflare.dev/v1. O ponto de entrada do gateway é POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Gerar uma imagem

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

Solicitar notas

Os modelos de imagem compatíveis com OpenAI usam prompt, n, size e quality; use a edição apenas quando a página oficial a documentar.

Parâmetros de solicitação

GPT Image usa a API de imagens compatível com OpenAI. A geração usa JSON; edição e edição guiada por máscara usam multipart. GPT Image 2 retorna dados de imagem Base64 em data[].b64_json.

Campo	Obrigatório	Notas
model	Sim	gpt-image-2
prompt	Sim	Instrução de geração ou edição
size	Não	auto ou personalizado WIDTHxHEIGHT dentro das regras de tamanho documentadas
quality	Não	low / medium / high / auto; padrão auto
background	Não	auto/opaque/transparent; fundos transparentes requerem saída PNG ou WebP
output_format	Não	png / jpeg / webp
output_compression	Não	0–100 para JPEG/WebP, padrão 100; ignorado para PNG
moderation	Não	auto / low; padrão auto
n	Não	1–10 saídas; padrão 1

Limites de resposta e entrada

Os tamanhos personalizados exigem que ambas as bordas sejam múltiplos de 16, uma proporção de 1:3 a 3:1, uma borda máxima de 3.840 pixels e um total de 655.360–8.294.400 pixels. A edição aceita até 16 imagens de origem, cada fonte e máscara com menos de 50 MB; não envie somente DALL·E response_format.

Editar imagens

GPT Image 2 edições usam /v1/images/edits com multipartes image/image[]; são aceitas até 16 imagens de entrada, e a máscara deve corresponder ao formato e dimensões da primeira imagem.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=保持主体不变，将背景替换为暖色摄影棚渐变" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "output_format=png" \
  -F "n=1"

Erros e tarefas com falha

Parâmetros de modelo inválidos retornam um 4xx com um ID de solicitação; use os campos de resposta e a mensagem de erro definidos pelo contrato modelo selecionado.

Escopo suportado

Esta página cobre chamadas de geração e edição de modelo Modelflare. O enriquecimento de pesquisa ou mapa, gerenciamento de voz e gerenciamento de biblioteca de elementos são APIs de recursos fora dessa superfície pública de chamada de modelo e não são campos de solicitação obrigatórios.

Preços e cobrança

Este modelo utiliza faturamento baseado em token. Consulte a página de preços do modelo para obter o preço atual do cliente, a lista de preços de referência e as especificações completas.

Nota

Esta página documenta a interface pública do Modelflare; os campos e limites mostrados aqui são o contrato atual.