Saltar al contenido principal
POST
Crear imagen
Crea una o varias imágenes a partir de una indicación de texto.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
requerido
prompt
string
requerido
models
string[]

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

Required array length: 1 - 25 elements
Minimum string length: 1
Ejemplo:
size
string
resolution
string
n
integer
Rango requerido: 1 <= x <= 10
quality
string
stream
boolean
partial_images
integer
Rango requerido: 0 <= x <= 3
output_format
enum<string>

Formato de salida. gif y svg requieren un modelo GPT Image 2.6 y no admiten stream ni partial_images. svg también requiere svg.model y n=1.

Opciones disponibles:
png,
jpeg,
webp,
gif,
svg
output_compression
integer
Rango requerido: 0 <= x <= 100
background
enum<string>
Opciones disponibles:
transparent,
opaque,
auto
moderation
enum<string>
Opciones disponibles:
auto,
low
complexity
enum<string>
Opciones disponibles:
low,
medium,
high
frame_count
integer
Rango requerido: 2 <= x <= 64
frame_duration_ms
integer
Rango requerido: 20 <= x <= 2000
svg
object

Obligatorio cuando output_format es svg. svg.model es el modelo de texto de OpenAI que escribe el SVG a partir de la imagen de referencia. Sus tokens se cobran a los precios de texto de ese modelo, con los tokens de razonamiento contados como salida, además del coste de la imagen.

response_format
string
style
string
user
string
provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

Respuesta

Respuesta de imagen

created
integer
data
object[]
svg_usage
object
Última modificación el 16 de noviembre de 2026