Configuración de la API de imágenes de OpenAI
La generación de imágenes no es la interfaz de chat habitual. Incluso si un proveedor de IA admite modelos de texto, no significa necesariamente que admita la interfaz de imágenes de OpenAI. Comprueba con el proveedor si menciona explícitamente 'Images API', 'generación de imágenes' o el modelo correspondiente antes de configurarlo.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
Primero confirma si el proveedor admite la interfaz de imágenes
| Qué verificar | Cómo comprobarlo | Por qué |
|---|---|---|
| Tipo de interfaz | Si el panel o la documentación mencionan explícitamente Images API, generación de imágenes o edición de imágenes | Que solo indique interfaz de chat compatible con OpenAI no significa que la interfaz de imágenes también esté disponible |
| Permisos del modelo | Si la lista de modelos incluye modelos de imagen y si la cuenta o la clave (Key) tienen permisos | Los modelos de imagen a menudo se facturan y se activan por separado de los modelos de texto |
| Ruta de solicitud | Si el proveedor ha proporcionado ejemplos para la interfaz de imágenes | Algunos proveedores solo retransmiten la interfaz de chat; solicitar directamente la ruta de imágenes dará un error 404 |
| Precio | Las imágenes se cobran por unidad, tamaño o calidad | Haz pruebas con pocas cantidades antes de generar por lotes para evitar un consumo elevado de golpe |
Diferencias con la interfaz de chat
| Tipo | Interfaces comunes | Preparación necesaria |
|---|---|---|
| Chat de texto | /v1/chat/completions o Responses | Key, Base URL, nombre del modelo, contenido del mensaje |
| Generación de imágenes | /v1/images/generations | Key, modelo de imagen, prompt, tamaño, formato de salida |
| Edición de imágenes | Interfaz de edición de imágenes | Además del prompt, también necesitas subir la imagen original o la máscara |
Cómo rellenar los campos
| Elemento de configuración | Forma de rellenarlo |
|---|---|
| Endpoint | https://api.openai.com/v1/images/generations |
| Modelo | Ejemplo oficial disponible: <code>gpt-image-2</code>; para servicios de proveedores, rellena según la lista del proveedor |
| Prompt | Qué imagen deseas generar |
| Tamaño | Tamaño de la imagen |
| Formato | URL o base64 |
Si utilizas un proveedor, reemplaza la parte del dominio oficial con la dirección de API de imágenes proporcionada por el proveedor; si el proveedor no especificó soporte para la interfaz de imágenes, no asumas que está disponible. Que la Base URL incluya o no /v1 debe seguir siempre el ejemplo del panel, no lo adivines por tu cuenta.
Ejemplo de solicitud
Ejemplo de generación de imágenes de OpenAI
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'El coste de la interfaz de imágenes suele ser diferente al de la interfaz de texto. Comprueba el precio antes de generar por lotes.
| Error | Causas comunes | Soluciones |
|---|---|---|
| 404 / endpoint not found | El proveedor no dispone de interfaz proxy para imágenes, o la ruta tiene demasiadas/pocas barras /v1 | Accede al panel para buscar un ejemplo específico de interfaz de imágenes; no utilices directamente la interfaz de chat |
| model not found | El nombre del modelo de imagen no está en la lista actual del proveedor | Copia el ID o nombre original del modelo de imagen, no el de un modelo de texto |
| unsupported content type | La interfaz de edición de imágenes requiere subir archivos; no puedes enviar simplemente JSON | Primero confirma si estás llamando a la interfaz de generación o a la de edición |