Entorno de pruebas

El entorno de pruebas le permite depurar una integración —el envío, la consulta del estado, el análisis de resultados, los webhooks y la verificación de firmas— sin gastar créditos y sin ejecutar una generación real. Cualquier clave con el prefijo clipia_test_ funciona en este modo: el envío devuelve de inmediato una tarea terminada con un recurso de muestra fijo.

Cómo activarlo

1. Abra la Developer Console, vaya a API Keys y haga clic en Create key.
2. Elija el entorno de prueba. La clave recibe el prefijo clipia_test_.
3. Utilícela exactamente igual que una clave de producción, en cualquiera de las cabeceras admitidas.

Para pasar a la generación real, sustituya la clave por una clipia_live_, sin cambiar el código. Una clave de prueba no requiere comprar créditos.

Cómo se comporta el entorno de pruebas

• No se cobran créditos. El saldo no cambia, aunque sea cero.
• No se ejecuta ninguna generación real. La tarea nunca llega a la cola de un modelo.
• El resultado está listo al instante. El envío devuelve status: COMPLETED y queue_position: 0.
• El resultado es una muestra fija en media.clipia.ai, una por tipo de contenido: imagen, vídeo y audio.
• cost se calcula, pero no se cobra. Es lo que costaría la misma tarea con una clave de producción.
• Los webhooks se envían. Si indica un webhook_url, la entrega se firma exactamente igual que en producción, así que puede probar su controlador y la verificación de la firma.
• El registro se conserva 24 horas. Puede consultar el estado y el resultado de una tarea de prueba durante un día.
• Los límites de frecuencia y la idempotencia se aplican igual que con una clave de producción.
• Los parámetros ignorados se notifican igual. Una clave de input que el modelo no aplicará se devuelve en warnings, como con una clave de producción; en MCP esa llamada se rechaza.
• El chat con LLM con una clave de prueba devuelve una respuesta predefinida con un coste de 0.

Ejemplo

# CLIPIA_KEY=clipia_test_...
curl -X POST https://api.clipia.ai/v1/models/nano-banana-2 \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "prompt": "a sunset over mountains, cinematic" } }'

import { createClient } from "clipia-ai";

// CLIPIA_KEY=clipia_test_...
const clipia = createClient({ apiKey: process.env.CLIPIA_KEY! });

const job = await clipia.queue.submit("nano-banana-2", {
  input: { prompt: "a sunset over mountains, cinematic" },
});

console.log(job.status); // "COMPLETED"

import os
from clipia import Clipia

# CLIPIA_KEY=clipia_test_...
clipia = Clipia(api_key=os.environ["CLIPIA_KEY"])

job = clipia.submit("nano-banana-2", {"prompt": "a sunset over mountains, cinematic"})

print(job.status)  # "COMPLETED"

{
  "request_id": "9c2f7a10-3e44-4b1a-bb9d-77e5c0a1d2e3",
  "status": "COMPLETED",
  "queue_position": 0,
  "status_url":   "https://api.clipia.ai/v1/requests/9c2f7a10-.../status",
  "response_url": "https://api.clipia.ai/v1/requests/9c2f7a10-...",
  "cost": 12
}

Obtenga el resultado igual que en producción:

curl https://api.clipia.ai/v1/requests/9c2f7a10-... \
  -H "Authorization: Bearer $CLIPIA_KEY"

{
  "request_id": "9c2f7a10-...",
  "status": "COMPLETED",
  "model": "nano-banana-2",
  "output": {
    "images": [
      { "url": "https://media.clipia.ai/sandbox/v1/sample-image.png", "width": 1024, "height": 1024 }
    ]
  },
  "cost": 12,
  "created_at": "2026-10-09T12:00:00Z",
  "completed_at": "2026-10-09T12:00:00Z"
}

Recursos de muestra