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.

ModeloFabricantePara qué
nova-canvasAmazon NovaUso general, buena relación calidad/precio.
stable-image-coreStability AIRápido y económico.
sd3.5-largeStability AIMás detalle y fidelidad al texto.
stable-image-ultraStability AILa 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}'
CampoObligatorioValores
modelsíUn modelo de imagen del catálogo.
promptsíHasta 4.000 caracteres.
nnoDe 1 a 4 imágenes (por defecto 1). Se cobra cada una.
sizeno1024x1024 (por defecto), 512x512, 1024x768, 768x1024, 1280x720, 720x1280.
response_formatnoSó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ódigoErrorCuándo
400model_not_imageEl modelo no es de imagen.
400invalid_sizeTamaño no admitido.
400content_policyEl proveedor rechazó el prompt por su política de contenido (no se cobra).
403model_not_allowedLa 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.