Texto a imagen
Genere una imagen a partir de una instrucción de texto.
¿No va a escribir código? Consulte Generar imágenes en sus propias herramientas.
Antes de empezar
https://api.ofox.ai/v1openai/gpt-image-2.5-flarepip install openaiCódigo
Todos los ejemplos siguientes se han ejecutado tal cual. El resultado se guarda como output.png en el directorio actual.
cURL
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.pngAjustes habituales
Cambie un parámetro en la petición anterior:
Tamaño (size) y calidad (quality)
- Tamaño
size: ancho y alto múltiplos de 16, lado mayor ≤ 3840, relación de aspecto entre 1:3 y 3:1, píxeles totales ≥ 655.360.768x768falla;1024x768funciona. Si se omite, decide el modelo; en nuestras pruebas fue 1254×1254. Consulte Tamaño. - Calidad
quality: compruebe primero que funciona conlowy después suba de nivel. Omitirlo no equivale amedium; el modelo elige un nivel por sí mismo.gpt-image-2no tienexhighnimax. El consumo por nivel figura en Calidad.
Valores de los parámetros
Valores admitidos y valores predeterminados medidos para esta familia. Para size y quality, consulte Tamaño y Calidad en la página de descripción general.
openai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2Distingue entre mayúsculas y minúsculas; un uso incorrecto devuelve 404. Escriba el ID completo con el prefijo openai/.
Cada imagen se factura por separado. Un valor superior a 10 devuelve 400.
Se ha comprobado que los tres funcionan.
▶Avanzados · 4output_compression · background · moderation · partial_imagesExpand
Solo se aplica a jpeg y webp.
Un fondo transparente requiere png o webp; jpeg no admite transparencia.
Nivel de rigor de la moderación de contenido.
Se utiliza con stream: true: cuántas imágenes intermedias se envían durante la generación.
Errores habituales
Para otros errores, consulte la tabla completa de errores.
Documentación oficial
La documentación de OpenAI describe el comportamiento al llamar directamente a OpenAI. Cuando llama a través de OfoxAI, prevalecen los resultados medidos en estas páginas. Por ejemplo, no es necesario fijar un proveedor para la edición.