Результат генерации

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

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

Authorization: Bearer <CLIPIA_API_KEY>

curl -X GET "https://example.com/v1/requests/764cabcf-b745-4b3e-ae38-1200304cf45b"

{  "request_id": "764cabcf-b745-4b3e-ae38-1200304cf45b",  "status": "COMPLETED",  "model": "nano-banana-2",  "output": {    "images": [      {        "url": "https://media.clipia.ai/works/8f3a1c7e.webp",        "original_url": "https://media.clipia.ai/works/8f3a1c7e.png"      }    ]  },  "cost": 12,  "created_at": "2026-06-01T12:00:00Z",  "completed_at": "2026-06-01T12:00:18Z"}

GET /v1/requests/:id возвращает результат с полем output и кодом 200, когда статус терминальный (COMPLETED, FAILED или CANCELED). Все ссылки ведут на CDN media.clipia.ai. Отдельное право ключа не требуется.

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

curl https://api.clipia.ai/v1/requests/764cabcf-b745-4b3e-ae38-1200304cf45b \
  -H "Authorization: Bearer $CLIPIA_KEY"

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

{
  "request_id": "764cabcf-b745-4b3e-ae38-1200304cf45b",
  "status": "COMPLETED",
  "model": "nano-banana-2",
  "output": {
    "images": [
      {
        "url": "https://media.clipia.ai/....webp",
        "original_url": "https://media.clipia.ai/....png"
      }
    ]
  },
  "cost": 12,
  "created_at": "2026-10-09T12:00:00Z",
  "completed_at": "2026-10-09T12:00:18Z"
}

output.images — массив. url — оптимизированная копия в WebP для показа, original_url — исходный файл полного качества. original_url есть только у первого изображения в массиве.

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

{
  "request_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "status": "COMPLETED",
  "model": "seedance-2-fast-i2v",
  "output": {
    "video": {
      "url": "https://media.clipia.ai/....mp4",
      "original_url": "https://media.clipia.ai/....mp4",
      "thumbnail_url": "https://media.clipia.ai/....webp"
    }
  },
  "cost": 40,
  "created_at": "2026-10-09T12:00:00Z",
  "completed_at": "2026-10-09T12:00:42Z"
}

output.video — объект с url. Поля original_url и thumbnail_url (кадр-превью) могут отсутствовать.

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

{
  "output": {
    "audio": { "url": "https://media.clipia.ai/....mp3", "format": "mp3" },
    "audios": [
      { "url": "https://media.clipia.ai/....mp3", "format": "mp3" },
      { "url": "https://media.clipia.ai/...-2.mp3", "format": "mp3" }
    ]
  }
}

output.audio — первый трек, output.audios — все варианты: музыкальные модели отдают несколько треков за один запуск, у озвучки вариант один. Первый элемент audios совпадает с audio. Поле format — формат файла по расширению ссылки (mp3, wav); его может не быть.

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

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

Если звук был включён, но звуковая дорожка не прошла проверку безопасности модели, сервер один раз повторяет генерацию без звука. Запрос завершается COMPLETED, а ответ дополнительно содержит массив warnings:

{
  "status": "COMPLETED",
  "output": { "video": { "url": "https://media.clipia.ai/....mp4" } },
  "warnings": [
    {
      "code": "audio_dropped",
      "parameter": "generate_audio",
      "message": "The audio track did not pass the model's safety check, so the video is generated without sound. The price of the request is unchanged."
    }
  ]
}

Стоимость запроса при этом не меняется. Поля warnings нет, когда предупреждать не о чем, а также у FAILED и CANCELED. Тот же массив приходит в ответе 202 и в статусе запроса, пока ролик без звука ещё создаётся. Сейчас это единственная причина; незнакомый code читайте как «параметр не применён».

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

При status: "FAILED" объект error несёт код из закрытого словаря — по нему клиент решает, повторять ли запрос. Сообщение error.message на английском: готовая фраза о причине, если сервер её опознал, иначе нейтральный текст по коду, обычно Generation failed. Please retry or contact support.; имён внутренних систем в нём нет. Кредиты за FAILED возвращаются всегда.

Тот же словарь использует вебхук об ошибке. Список может пополняться: незнакомый код обрабатывайте как generation_failed.

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