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

Тестовый режим (песочница) нужен, чтобы отладить интеграцию — отправку, опрос, разбор результата, вебхуки и проверку подписи — без списания кредитов и без реальной генерации. Им пользуется любой ключ с префиксом clipia_test_: отправка сразу возвращает завершённую задачу с фиксированным образцом.

Как включитьСкопировать ссылку на раздел

1. Откройте консоль разработчика, вкладка API-ключи → Создать ключ.
2. Выберите тестовую среду. Ключ получит префикс clipia_test_.
3. Используйте его так же, как боевой, в любом из поддерживаемых заголовков.

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

Как ведёт себя песочницаСкопировать ссылку на раздел

• Кредиты не списываются. Баланс не меняется, даже если он нулевой.
• Реальная генерация не запускается. Задача не попадает в очередь моделей.
• Результат готов сразу. Отправка возвращает status: COMPLETED и queue_position: 0.
• Результат — фиксированный образец на media.clipia.ai, своего типа для изображений, видео и аудио.
• cost считается, но не списывается. Это цена, которую та же задача стоила бы на боевом ключе.
• Вебхук приходит. Если передан webhook_url, доставка подписана так же, как в боевом режиме, поэтому можно проверить обработчик и подпись. Доставки ограничены: не больше одной в минуту на ключ, остальные не создаются, а неудачная доставка повторяется не дальше трёх попыток.
• Запись хранится 24 часа. Статус и результат тестовой задачи можно запросить в течение суток.
• Лимиты и идемпотентность отправки генераций действуют так же, как на боевом ключе.
• Проигнорированные параметры видны так же. Ключ input, который модель не применит, возвращается в warnings, как на боевом ключе; в MCP такой вызов отклоняется.
• LLM-чат на тестовом ключе возвращает заготовленный ответ со стоимостью 0. Диапазоны параметров (temperature, top_p, n, размер tools, max_tokens) проверяются как на боевом ключе; модель и messages не проверяются, а Idempotency-Key не даёт повторного ответа.

ПримерСкопировать ссылку на раздел

# 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" } }'

{
  "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
}

Результат забирается так же, как в боевом режиме:

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",
        "original_url": "https://media.clipia.ai/sandbox/v1/sample-image.png"
      }
    ]
  },
  "cost": 12,
  "created_at": "2026-10-09T12:00:00Z",
  "completed_at": "2026-10-09T12:00:00Z"
}

ОбразцыСкопировать ссылку на раздел