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.
Antes de começar
https://api.ofox.io/v1openai/gpt-image-2.5-flarepip install openaiCódigo
Todos os exemplos abaixo foram executados sem alterações. O resultado é salvo como output.png no diretório atual.
cURL
curl -s https://api.ofox.io/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.pngAjustes comuns
Altere um parâmetro na requisição acima:
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.768x768falha;1024x768funciona. Se omitido, o modelo decide; em nossos testes foi 1254×1254. Consulte Tamanho. - Qualidade
quality: faça funcionar primeiro comlowe depois aumente. Omitir não é o mesmo quemedium; o modelo escolhe o nível por conta própria.gpt-image-2não temxhighnemmax. 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.
openai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2Diferencia maiúsculas de minúsculas; uma grafia incorreta retorna 404. Escreva o ID completo com o prefixo openai/.
Cada imagem é cobrada separadamente. Acima de 10 retorna 400.
Os três foram medidos e funcionam.
▶Avançados · 4output_compression · background · moderation · partial_imagesExpand
Aplica-se somente a jpeg e webp.
Um fundo transparente requer png ou webp; jpeg não tem transparência.
O rigor da moderação de conteúdo.
Usado com stream: true: quantas imagens intermediárias enviar durante a geração.
Erros comuns
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.