Тестовый режим

Тестовый режим (песочница) позволяет отладить интеграцию — submit → status → result, опрос, вебхуки и проверку подписи — без списания кредитов и без обращения к реальной генерации. Любой ключ с префиксом clipia_test_… работает в этом режиме: submit мгновенно возвращает детерминированный mock-результат с фиксированным sample-ассетом.

Как включить

1. В личном кабинете (Консоль разработчика → API-ключи) при создании ключа переключите тумблер среды на «Тестовая».
2. Полученный ключ имеет префикс clipia_test_…. Используйте его так же, как боевой — в любом из поддерживаемых заголовков.

Authorization: Bearer clipia_test_xxxxxxxxxxxxxxxxxxxxxx

Тестовый и боевой ключи независимы: чтобы перейти на реальную генерацию, замените ключ на clipia_live_… — код менять не нужно.

Поведение

При вызове с clipia_test_…-ключом:

• Кредиты не списываются — баланс не затрагивается, боевой баланс для песочницы не нужен.
• Реальная генерация не запускается — запрос не уходит в очередь.
• Результат готов мгновенно — submit сразу возвращает status: COMPLETED, минуя IN_QUEUE/IN_PROGRESS, с queue_position: 0.
• Output — фиксированный sample-ассет на media.clipia.ai: для image-моделей изображение, для video-моделей видео.
• cost в ответе — расчётная стоимость (сколько операция стоила бы на боевом ключе), но она не списывается.
• Вебхуки приходят — если передан webhook_url, доставка отправляется тем же подписанным механизмом (HMAC-SHA256, заголовок X-Clipia-Signature), что и в бою. Это позволяет протестировать обработчик и проверку подписи.
• Лимиты и идемпотентность действуют как обычно: RPM-лимит и Idempotency-Key работают так же, как в боевом режиме.

Пример

# Submit с тестовым ключом — результат сразу COMPLETED
curl -X POST https://api.clipia.ai/v1/models/nano-banana-2 \
  -H "Authorization: Bearer $CLIPIA_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "prompt": "a sunset over mountains, cinematic" } }'

import { Clipia } from "clipia-ai";

// Тестовый ключ clipia_test_* — результат сразу COMPLETED
const clipia = new Clipia({ apiKey: process.env.CLIPIA_TEST_KEY });

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

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

import os
from clipia import Clipia

# Тестовый ключ clipia_test_* — результат сразу COMPLETED
clipia = Clipia(api_key=os.environ["CLIPIA_TEST_KEY"])

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

print(result.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
}

# Result — забрать sample-output
curl https://api.clipia.ai/v1/requests/9c2f7a10-... \
  -H "Authorization: Bearer $CLIPIA_TEST_KEY"

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

Для video-моделей output содержит video: { url: "https://media.clipia.ai/sandbox/sample-video.mp4", width, height, duration }.