Skip to Content
ModelosGPT ImageTexto para imagem

Texto para imagem

Gerar uma imagem a partir de um prompt de texto.

Não vai escrever código? Consulte Gerar imagens nas suas próprias ferramentas.

POST/v1/images/generationsParâmetros comuns Experimentar

Antes de começar

Você precisa deDetalhes
Chave de APICrie uma no console da OfoxAI  e substitua YOUR_OFOX_API_KEY no código
AmbienteO cURL precisa do jq para decodificar a imagem; o Python precisa de pip install openai; Node.js 18 ou superior, sem dependências
TimeoutDefina o timeout do cliente em 600 segundos. Alta qualidade, tamanhos grandes ou edição podem levar vários minutos
Valores usados no código
URL da APIhttps://api.ofox.ai/v1
ID do modeloopenai/gpt-image-2.5-flare
Chave de APISubstitua YOUR_OFOX_API_KEY no código pela sua chave
Dependências Pythonpip install openai

Código

Todos os exemplos abaixo foram executados sem alterações. O resultado é salvo como output.png no diretório atual.

Terminal
curl -s https://api.ofox.ai/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "A red apple on a white table, soft natural light", "size": "1024x1024", "quality": "low" }' \ -o response.json # The image comes back as base64 — decode and save it (needs jq; on error, read response.json) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Ajustes comuns

Altere um parâmetro na requisição acima:

Para obterAltereObservações
Outro tamanhosizeTamanhos personalizados devem atender às quatro regras
Melhor qualidadequalityNíveis mais altos custam mais e demoram mais — consulte Qualidade
Arquivos menoresoutput_format, output_compressionMude para jpeg ou webp e depois defina a compressão
Várias imagensn1–10, cada uma cobrada separadamente

Tamanho (size) e qualidade (quality)

  • Tamanho size: largura e altura múltiplas de 16, maior lado ≤ 3840, proporção entre 1:3 e 3:1, total de pixels ≥ 655.360. 768x768 falha; 1024x768 funciona. Se omitido, o modelo decide; em nossos testes foi 1254×1254. Consulte Tamanho.
  • Qualidade quality: faça funcionar primeiro com low e depois aumente. Omitir não é o mesmo que medium; o modelo escolhe o nível por conta própria. gpt-image-2 não tem xhigh nem max. O consumo por nível está em Qualidade.

Valores dos parâmetros

Valores aceitos e padrões medidos para esta família. Para size e quality, consulte Tamanho e Qualidade na página de visão geral.

Obrigatórios
modelobrigatóriostring· valoresopenai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

Diferencia maiúsculas de minúsculas; uma grafia incorreta retorna 404. Escreva o ID completo com o prefixo openai/.

Comuns
ninteger· padrão 1· valores1–10

Cada imagem é cobrada separadamente. Acima de 10 retorna 400.

output_formatstring· padrão png· valorespngjpegwebp

Os três foram medidos e funcionam.

▶Avançados · 4output_compression · background · moderation · partial_imagesExpand
output_compressioninteger· valores0–100

Aplica-se somente a jpeg e webp.

backgroundstring· padrão opaque· valoresopaquetransparentauto

Um fundo transparente requer png ou webp; jpeg não tem transparência.

moderationstring· valoresautolow

O rigor da moderação de conteúdo.

partial_imagesinteger· valores0–3

Usado com stream: true: quantas imagens intermediárias enviar durante a geração.

Erros comuns

ErroCausaSolução
moderation_blockedO prompt foi bloqueado pelo sistema de segurança do provedor upstreamAltere o prompt e tente novamente; repetir sem alterações produz o mesmo resultado
Transparent background is not supported for JPEG output formatFundo transparente solicitado com jpegUse png ou webp
404 model_not_foundID do modelo com erro de digitação ou de maiúsculas/minúsculasCopie o ID do modelo desta página
Invalid sizeO tamanho viola uma das quatro regras acimaAjuste-o conforme descrito em Tamanho e qualidade
does not support quality 'xhigh'xhigh ou max enviado para gpt-image-2Use high ou mude para 2.5
Invalid value: 'standard'quality definido como standard ou hdUse de low a max
429 rate_limit_exceededMais de 100 requisições por minuto (por equipe)Tente novamente mais tarde

Para outros erros, consulte a tabela completa de erros.

Documentação oficial

A documentação da OpenAI descreve o comportamento ao chamar a OpenAI diretamente. Ao chamar pela OfoxAI, os resultados medidos nestas páginas prevalecem. Por exemplo, não é necessário fixar um provedor para edição.

Last updated on