Imágenes
Genera imágenes a partir de una descripción con el mismo endpoint que OpenAI: POST /v1/images/generations. Se cobra por imagen (no por tokens), del saldo de tu empresa y del presupuesto del equipo de la key, como el resto de peticiones.
| Modelo | Fabricante | Para qué |
|---|---|---|
nova-canvas | Amazon Nova | Uso general, buena relación calidad/precio. |
stable-image-core | Stability AI | Rápido y económico. |
sd3.5-large | Stability AI | Más detalle y fidelidad al texto. |
stable-image-ultra | Stability AI | La máxima calidad (fotografía, producto). |
Los precios por imagen de cada modelo están en el panel, en Modelos → Imágenes, y GET /v1/models lista los que tu key puede usar.
Petición
import base64
from openai import OpenAI
client = OpenAI(base_url="https://api.quipua.com/v1", api_key="ci_live_xxx")
r = client.images.generate(
model="nova-canvas",
prompt="Foto de producto de una taza de café sobre una mesa de madera, luz natural",
size="1024x1024",
n=1,
response_format="b64_json",
)
with open("taza.png", "wb") as f:
f.write(base64.b64decode(r.data[0].b64_json))import OpenAI from "openai";
import { writeFileSync } from "node:fs";
const client = new OpenAI({ baseURL: "https://api.quipua.com/v1", apiKey: "ci_live_xxx" });
const r = await client.images.generate({
model: "nova-canvas",
prompt: "Foto de producto de una taza de café sobre una mesa de madera, luz natural",
size: "1024x1024",
n: 1,
response_format: "b64_json",
});
writeFileSync("taza.png", Buffer.from(r.data[0].b64_json, "base64"));curl https://api.quipua.com/v1/images/generations \
-H "Authorization: Bearer ci_live_xxx" \
-H "Content-Type: application/json" \
-d '{"model": "nova-canvas", "prompt": "Foto de producto de una taza de café", "size": "1024x1024", "n": 1}'| Campo | Obligatorio | Valores |
|---|---|---|
model | sí | Un modelo de imagen del catálogo. |
prompt | sí | Hasta 4.000 caracteres. |
n | no | De 1 a 4 imágenes (por defecto 1). Se cobra cada una. |
size | no | 1024x1024 (por defecto), 512x512, 1024x768, 768x1024, 1280x720, 720x1280. |
response_format | no | Sólo b64_json: Quipua no aloja las imágenes. |
La respuesta tiene la forma de OpenAI ({"created": …, "data": [{"b64_json": "…"}]}) y las cabeceras x-ci-model-served, x-ci-request-id y x-ci-price-usd (lo cobrado).
Saldo, límites y errores
Antes de llamar al proveedor se reserva el máximo (n × precio por imagen): si no cabe en el saldo, el presupuesto del equipo o el límite de la key, la respuesta es 402 o 403 como en el chat (Saldo, presupuestos y límites). Si el proveedor no devuelve imagen, no se cobra.
| Código | Error | Cuándo |
|---|---|---|
| 400 | model_not_image | El modelo no es de imagen. |
| 400 | invalid_size | Tamaño no admitido. |
| 400 | content_policy | El proveedor rechazó el prompt por su política de contenido (no se cobra). |
| 403 | model_not_allowed | La key no tiene permiso para ese modelo. |
Privacidad: Quipua no guarda ni el prompt ni las imágenes; vuelven en la respuesta y se olvidan. Estos modelos se ejecutan en Estados Unidos.