Saltar al contenido principal
POST
Usa gpt-image-2.6-ext con version igual a flare / sunburst. Facturación por imagen. Compatible con resolution 1k / 2k / 4k y n: 1, todos los niveles de calidad y PNG / JPEG / WebP / SVG / GIF.
Esta es la API Ext. El nombre y las reglas difieren de los modelos GPT-Image-2.6 facturados por tokens.

Autenticación

string
requerido
Usa una clave de la plataforma con Bearer Token. Obténla en la página de claves API. Envía Content-Type: application/json.

Elegir versión

Parámetros

Los valores enumerados no distinguen mayúsculas y se recortan los espacios externos. Los ejemplos usan minúsculas.
string
requerido
Valor fijo: gpt-image-2.6-ext.
string
requerido
Instrucciones obligatorias y no vacías. Con varias referencias, identifica la primera o segunda imagen y describe qué cambiar y conservar.
string
predeterminado:"flare"
flare / sunburst; predeterminado flare. Otros valores: HTTP 400. Los precios pueden diferir entre versiones.
string
predeterminado:"1k"
1k / 2k / 4k (también se aceptan en mayúsculas 1K / 2K / 4K). Junto con la proporción de size determina los píxeles de salida; consulta la tabla “Proporciones y dimensiones” más abajo. El precio por imagen varía según el nivel; valores como hd / 8k devuelven HTTP 400.
string
predeterminado:"auto"
Solo auto o las 10 proporciones de abajo, no píxeles como 1024x1024. Con texto, auto da 1:1. En edición selecciona la proporción compatible más cercana a la primera referencia cuyas dimensiones se puedan leer. Para GIF, omite el campo o usa auto.
string
Alias de size; basta con uno. Si se envían ambos deben coincidir, de lo contrario HTTP 400. Para GIF, también omítelo o usa auto.
integer
predeterminado:"1"
Usa actualmente el entero 1.
string
auto / low / medium / high / xhigh / max. Si se omite, no se transmite y el proveedor elige automáticamente. auto no está fijado en low. El precio no cambia; los niveles altos suelen tardar más. Otros valores: HTTP 400.
string
predeterminado:"png"
png / jpeg / webp / svg / gif; jpg es alias de jpeg. SVG y GIF solo admiten generación desde texto. Otros formatos: HTTP 400.
La salida SVG aún no es compatible.
string
low / medium / high; si se omite, decide el proveedor. Controla la complejidad: low para iconos simples e ilustraciones planas, high para más detalles. No cambia el precio por imagen.
string[]
Hasta 16 imágenes de 20 MB como máximo cada una. PNG / JPEG / WebP / GIF / BMP. URL HTTP(S) públicas o Data URL de imagen como data:image/png;base64,.... Incluir referencias activa la edición. SVG y GIF no admiten referencias.
Cuando resolution es 2k / 4k, las imágenes de referencia no pueden ser GIF / BMP.
Alias admitidos: image_url, image, images, input_image, input_images. Se recomienda image_urls. Las URL deben ser públicas y accesibles sin iniciar sesión.

Proporciones y dimensiones

Con auto, texto a imagen usa 1:1: 1024×1024 en 1k, 2048×2048 en 2k y 2880×2880 en 4k. La edición selecciona la proporción más cercana de la tabla, sin garantizar los píxeles originales.

Ejemplo con referencias

La edición también usa POST /v1/images/generations. Sustituye las URL de ejemplo por imágenes accesibles.

Salida SVG

Usa output_format: "svg". Solo texto a imagen y n=1. size acepta proporciones; complexity: "low" es adecuado para gráficos vectoriales simples.
object
Configuración opcional del modelo que escribe SVG, exclusiva de SVG. El objeto completo se puede omitir. El modelo de texto no tiene cargo adicional.

GIF animados

Usa output_format: "gif". Solo texto a imagen. Omite size / aspect_ratio o usa auto; proporciones y píxeles devuelven HTTP 400. Describe el movimiento y el bucle.

Parámetros no admitidos e ignorados

Envío y resultados

El envío correcto devuelve HTTP 200. Lee data[0].task_id y consulta la API de estado cada 3–5 segundos hasta completed o failed. Si el cliente agota el tiempo, sigue consultando la tarea existente en lugar de generar otra.
El ejemplo muestra el objeto de tarea. Si la respuesta tiene una envoltura {code, data}, lee primero data. Los ejemplos Python / JavaScript admiten ambas formas.
result.images[0].url es un array; el primer enlace es result.images[0].url[0]. Descarga antes de expires_at; la vigencia recomendada es de 24 horas tras finalizar. cost / credits_cost indican los cargos finales. Consulta por lotes: POST /v1/tasks/batch con {"task_ids":["task_xxx","task_yyy"]}.

Facturación

El precio por imagen depende solo de version × resolution. Calidad, formato (SVG / GIF incluidos), complejidad, proporción, número de referencias y svg.model no lo cambian. Usa actualmente n=1; los fallos se reembolsan por completo. Consulta la página de precios APIMart o /api/pricing.

Gestión de errores