Видео в CLODEx: Studio и API для Veo, Kling, Seedance и Hailuo

В CLODEx можно выбрать доступную видеомодель и работать с ней через интерфейс сайта или поддерживаемый API-маршрут. В каталоге представлены семейства Veo, Kling, Seedance, Hailuo и другие. Конкретные версии и режимы нужно проверять перед запуском: текстовое описание семейства не гарантирует поддержку любого входного формата.

Сначала попробуйте через сайт

Откройте Studio или доступный раздел видео. Выберите модель, укажите описание сцены и поддерживаемый тип входа: текст, изображение или видео. Проверьте длительность, разрешение, соотношение сторон, наличие звука и оценку стоимости.

Для первого теста используйте короткий ролик. Одна удачная генерация не гарантирует такую же скорость и результат для другого промпта или модели.

Важно: нужен платный баланс

Согласно документации CLODEx, видеомодели используют платный баланс кошелька. Промобаланс, CLODEx Credits и лимит подписки для них не используются. Перед запуском проверьте подходящие средства в кошельке, а не только общий остаток в интерфейсе.

Цена зависит от модели и параметров. Не переносите стоимость текстовых токенов на видео и не считайте повторную генерацию бесплатной по умолчанию.

Подключение по API

Создайте отдельный ключ в кабинете. В документации видео опубликован асинхронный маршрут:

Действие	Метод и путь
Создать задачу	POST /v1/videos/generations
Проверить состояние	GET /v1/videos/{request_id}
Получить готовый результат	GET /v1/videos/{request_id}/content

Используйте идентификатор, возвращённый при создании. Не генерируйте его сами и не подставляйте ID другого пользователя или другой задачи.

Пример JSON-тела из поддерживаемого сценария; ID модели и комбинацию параметров предварительно сверяйте в /docs:

{
  "model": "clodex-video/seedance-2.5",
  "prompt": "Камера медленно движется над заснеженными горами на рассвете",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Отправьте тело на https://clodex.xyz/v1/videos/generations с Content-Type: application/json и Authorization: Bearer YOUR_CLODEX_API_KEY. Это платная генерация, не бесплатная проверка ключа.

Жизненный цикл задачи

Сохраните ID после создания, затем периодически запрашивайте статус с ограниченной частотой. Получение ID означает принятие задачи, а не готовность видео. Скачивайте результат после подтверждённого успешного завершения.

Если клиент потерял соединение, сначала выясните состояние уже созданной задачи. Слепое повторение POST может создать вторую платную генерацию. Не рассчитывайте на идемпотентность, пока её конкретный механизм не подтверждён документацией используемого метода.

Ошибки и тайм-ауты отображайте пользователю явно. Не обещайте точное время готовности или автоматический возврат без подтверждённых условий сервиса.

Что проверить до коммерческого использования

Проверьте ограничения модели, условия использования результатов, права на исходные изображения, видео, музыку и лица людей. Не делайте вывод «без водяных знаков» или «любое коммерческое использование разрешено» только по наличию модели в каталоге.

Для диагностики используйте ID задачи и безопасное описание ошибки. Ключи, приватные исходники и временные ссылки не публикуйте. Списание и сведения о выполнении сверяйте в кабинете и истории задач выбранного продукта.

Открыть Studio · Техническая документация · Изображения для исходных кадров · Озвучка и дубляж.