Respuesta rápida
- El punto de entrada es POST /v1/images/generations; defina model=gpt-image-2 en el cuerpo de la solicitud.
- Admite generación con prompt e imágenes de referencia por URL en reference_images para generación guiada o edición.
- Las imágenes de referencia solo admiten URL, por lo que los archivos locales deben subirse primero en lugar de enviar base64 directamente.
- El endpoint funciona con tareas asíncronas: devuelve un id de tarea y luego se consulta el resultado en el endpoint de estado de la tarea de imagen.
- El precio público oficial ronda los $0.22 / $0.50 / $1.30 por imagen en 1K / 2K / 4K; ToAPIs muestra actualmente $0.015 / $0.020 / $0.025 por imagen en la página comparativa, y la facturación final depende del precio de tu cuenta.
- Con la tarifa 1K de ToAPIs de $0.015 por imagen, una recarga de $10 equivale a unas 600 imágenes 1K adicionales; con la tarifa 4K de $0.025 por imagen, a unas 400 imágenes 4K.
Parámetros clave
- model | string | obligatorio | gpt-image-2 | - | Usa gpt-image-2 como identificador exacto del modelo.
- prompt | string | obligatorio | - | - | Prompt principal para generar o editar imágenes.
- size | string | opcional | 1:1 | 1K: 1:1 | 3:2 | 2:3; 2K: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9 | 9:21; 4K: 4:3 | 3:4 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9 | 9:21 | Relación de aspecto de salida; los valores admitidos dependen de la resolución elegida.
- resolution | string | opcional | 1K | 1K | 2K | 4K | Nivel de resolución de salida; debe coincidir con una combinación de size admitida.
- reference_images | string[] | opcional | - | Matriz de URL | Matriz de URL de imágenes de referencia para generación guiada o edición. Las imágenes locales deben subirse antes; no se admite base64 directo.
- image_urls | string[] | opcional | - | Matriz de URL (campo compatible) | Campo de compatibilidad; las llamadas antiguas siguen funcionando, pero en nuevas integraciones conviene usar reference_images.










