Generación de imágenes
POST /v1/images/generations acepta el formato de solicitud de imágenes de OpenAI y devuelve el formato de respuesta de imágenes de OpenAI, así que el SDK de openai funciona con solo cambiar la URL base.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.inferray.com/v1",
apiKey: process.env.INFERRAY_API_KEY,
});
const result = await client.images.generate({
model: "gemini-3-pro-image-preview",
prompt: "a quartz crystal on a workbench, studio lighting",
n: 1,
});
console.log(result.data[0].b64_json);
curl https://api.inferray.com/v1/images/generations \
-H "Authorization: Bearer $INFERRAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-preview",
"prompt": "a quartz crystal on a workbench, studio lighting",
"n": 1
}'
Los modelos de imagen van por separado
Los modelos de imagen solo responden en este endpoint. Si envías uno a /v1/chat/completions, /v1/responses o /v1/messages, recibes un 404 que indica los modelos que ese endpoint sí admite, y lo mismo ocurre a la inversa: un modelo de texto en este endpoint se rechaza en lugar de reenviarse.
La página de modelos indica qué modelos generan imágenes, y GET /v1/models los muestra junto con los modelos de texto.
Incluido en los Token Plans
La generación de imágenes está cubierta por un Token Plan. Cada imagen consume crédito de tu plan al precio de lista del modelo, igual que una solicitud de texto, así que obtiene el mismo uso de 3×. Las claves de proyectos de pago por uso también funcionan aquí.
Cómo funcionan los precios de las imágenes
Los modelos de texto se cotizan por cada 1M tokens. Los modelos de imagen no, y los proveedores no coinciden en una sola unidad:
| Modelo | Se cobra | Lo que ves |
|---|---|---|
gemini-3-pro-image-preview | Por imagen generada, según la resolución | $0.10 / image a 1K y 2K, más a 4K |
gpt-image-2 | Por cada 1M tokens de salida de imagen | Un precio por token, ya que no se publica una cifra por imagen |
gemini-2.5-flash-image | Por token, como un modelo de texto | Precios estándar de tokens de entrada y salida |
La página de cada modelo muestra la unidad en la que ese modelo realmente cobra, a la tarifa que tú pagas. No se suma ninguna comisión de gateway, igual que en todo lo demás.
Lo que se te cobra
Tu factura es el costo real en que incurrió la solicitud, a la tarifa indicada para el modelo. Nada se estima a partir del prompt, y nada se redondea hacia arriba a una cifra por imagen cuando el proveedor cobró por token. Por eso la resolución que pides cambia el precio en los modelos que cobran según la resolución: producir una imagen de 4K realmente cuesta más que una de 1K.
Streaming
Este endpoint no tiene modo de streaming. Una solicitud de imagen responde una sola vez, con la imagen terminada.