Skip to Content
ModelosGPT ImageTexto a imagen

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.

POST/v1/images/generationsParámetros comunes Probar

Antes de empezar

NecesitaDetalles
Clave de APICree una en la consola de OfoxAI  y sustituya YOUR_OFOX_API_KEY en el código
EntornocURL necesita jq para decodificar la imagen; Python necesita pip install openai; Node.js 18 o posterior, sin dependencias
Tiempo de esperaConfigure el tiempo de espera del cliente en 600 segundos. La alta calidad, los tamaños grandes o la edición pueden tardar varios minutos
Valores utilizados en el código
URL de la APIhttps://api.ofox.ai/v1
ID de modeloopenai/gpt-image-2.5-flare
Clave de APISustituya YOUR_OFOX_API_KEY en el código por su clave
Dependencias de Pythonpip install openai

Código

Todos los ejemplos siguientes se han ejecutado tal cual. El resultado se guarda como output.png en el directorio actual.

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 habituales

Cambie un parámetro en la petición anterior:

Para obtenerCambieNotas
Otro tamañosizeLos tamaños personalizados deben cumplir las cuatro reglas
Mejor calidadqualityLos niveles superiores cuestan más y tardan más — consulte Calidad
Archivos más pequeñosoutput_format, output_compressionCambie a jpeg o webp y, a continuación, configure la compresión
Varias imágenesn1–10, cada una se factura por separado

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. 768x768 falla; 1024x768 funciona. Si se omite, decide el modelo; en nuestras pruebas fue 1254×1254. Consulte Tamaño.
  • Calidad quality: compruebe primero que funciona con low y después suba de nivel. Omitirlo no equivale a medium; el modelo elige un nivel por sí mismo. gpt-image-2 no tiene xhigh ni max. 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.

Obligatorios
modelobligatoriostring· valoresopenai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

Distingue entre mayúsculas y minúsculas; un uso incorrecto devuelve 404. Escriba el ID completo con el prefijo openai/.

Comunes
ninteger· predeterminado 1· valores1–10

Cada imagen se factura por separado. Un valor superior a 10 devuelve 400.

output_formatstring· predeterminado png· valorespngjpegwebp

Se ha comprobado que los tres funcionan.

▶Avanzados · 4output_compression · background · moderation · partial_imagesExpand
output_compressioninteger· valores0–100

Solo se aplica a jpeg y webp.

backgroundstring· predeterminado opaque· valoresopaquetransparentauto

Un fondo transparente requiere png o webp; jpeg no admite transparencia.

moderationstring· valoresautolow

Nivel de rigor de la moderación de contenido.

partial_imagesinteger· valores0–3

Se utiliza con stream: true: cuántas imágenes intermedias se envían durante la generación.

Errores habituales

ErrorCausaSolución
moderation_blockedLa instrucción fue bloqueada por el sistema de seguridad del proveedor de origenModifique la instrucción y vuelva a intentarlo; reintentar sin cambios da el mismo resultado
Transparent background is not supported for JPEG output formatSe solicitó un fondo transparente con jpegUtilice png o webp
404 model_not_foundID de modelo mal escrito o con mayúsculas incorrectasCopie el ID de modelo de esta página
Invalid sizeEl tamaño incumple una de las cuatro reglas anterioresAjústelo como se describe en Tamaño y calidad
does not support quality 'xhigh'Se envió xhigh o max a gpt-image-2Utilice high o cambie a 2.5
Invalid value: 'standard'quality se estableció en standard o hdUtilice un valor entre low y max
429 rate_limit_exceededMás de 100 peticiones por minuto (por equipo)Vuelva a intentarlo más tarde

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.

Last updated on