Generación de imágenes
Genera y edita imágenes con la API de imágenes compatible con OpenAI: elige un modelo del catálogo, envía una solicitud y revisa el precio exacto.
Un mismo flujo para todos los modelos de imagen disponibles: elige un modelo, envía una solicitud, lee la respuesta y entiende el precio.
Todos los modelos, capacidades y precios Índice de la documentación para agentes de IA:https://oneprovider.dev/docs/llms.txt Elige modelos del catálogo común Esta guía no fija un modelo preferido. Los modelos de imagen disponibles y sus precios actuales siempre están en la tabla común de modelos . Modelos de imagen disponibles
gemini-3.1-flash-image Runnable - 0.5K
- 0,045 US$ / imagen
- 1K
- 0,067 US$ / imagen
- 2K
- 0,101 US$ / imagen
- 4K
- 0,151 US$ / imagen
gpt-image-2 Runnable - image input
- 8,00 US$ / 1M de tokens
- cached image input
- 2,00 US$ / 1M de tokens
- generated image output
- 30,00 US$ / 1M de tokens
gpt-image-2.5 Runnable - image input
- 8,00 US$ / 1M de tokens
- cached image input
- 2,00 US$ / 1M de tokens
- generated image output
- 30,00 US$ / 1M de tokens
gpt-image-2.5-flare Runnable - image input
- 8,00 US$ / 1M de tokens
- cached image input
- 2,00 US$ / 1M de tokens
- generated image output
- 30,00 US$ / 1M de tokens
gpt-image-2.5-sunburst Runnable - image input
- 8,00 US$ / 1M de tokens
- cached image input
- 2,00 US$ / 1M de tokens
- generated image output
- 30,00 US$ / 1M de tokens
gpt-image-2.6-flare Runnable - image input
- 8,00 US$ / 1M de tokens
- cached image input
- 2,00 US$ / 1M de tokens
- generated image output
- 30,00 US$ / 1M de tokens
gpt-image-2.6-sunburst Runnable - image input
- 8,00 US$ / 1M de tokens
- cached image input
- 2,00 US$ / 1M de tokens
- generated image output
- 30,00 US$ / 1M de tokens
grok-imagine Catálogo - per generation request
- 0,02 US$ / imagen
grok-imagine-image Runnable - per generated image
- 0,02 US$ / imagen
grok-imagine-image-2.0 Runnable - 1K
- 0,06 US$ / imagen
- 2K
- 0,08 US$ / imagen
grok-imagine-image-lite Runnable - per generated image
- 0,025 US$ / imagen
gemini-3-pro-image Catálogo - image input
- 2,00 US$ / 1M de tokens
- generated image output
- 120,00 US$ / 1M de tokens
gemini-3-pro-image-preview Catálogo - image input
- 2,00 US$ / 1M de tokens
- generated image output
- 120,00 US$ / 1M de tokens
gemini-3.1-flash-image-preview Catálogo - image input
- 0,50 US$ / 1M de tokens
- generated image output
- 60,00 US$ / 1M de tokens
Solicitud
POST /v1/images/generations. La ruta y los parámetros opcionales salen del contrato verificado del modelo elegido.
curl -sS https://api.oneprovider.dev/v1/images/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A quiet observatory above the clouds",
"size": "1024x1024",
"quality": "low"
}'Las capacidades varían según el modelo
Los tamaños, los niveles de calidad, la transparencia, la edición y los formatos de respuesta dependen del modelo. No copies los parámetros opcionales de un modelo a otro sin comprobar que los admite.
Respuesta
Un transporte síncrono devuelve los datos de la imagen o una URL de inmediato. Un transporte asíncrono devuelve un id de trabajo; consulta su ruta de estado y luego descarga desde su ruta de contenido.
Precios
La tabla común de modelos separa cada tarifa de tokens en su propia columna y muestra el cobro por imagen u otros medios en la columna de medios. Abrir precios .
Respuestas rápidas
¿Qué base URL uso?
Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .
¿Cómo me autentico?
Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .
¿Dónde obtengo una clave?
Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .
¿Qué significan 401, 404 y 429?
401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .
¿Por qué se cortan o se reinician los streams?
Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.
¿Dónde pregunto si esto no basta?
Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .
Última actualización: 2026-11-08 ¿Encontraste un error? @Oneproviderhelpbot