Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Используйте документацию по video models в CometAPI, выбрав workflow провайдера, который соответствует типу вашей задачи. Большинство video endpoints создают асинхронные задачи, поэтому сохраняйте task ID и используйте polling для получения результатов. Добавляйте callbacks только в том случае, если на странице конкретной модели документирована поддержка callback.

​
Выберите video API

Создать видео Sora

Создание задач видео Sora.

Получить видео Sora

Запрос задач видео Sora.

Runway image to video

Генерация видео Runway из изображений.

Kling text to video

Генерация видео Kling из текстовых Prompt.

Создание Seedance

Создание задач видео Seedance.

Генерация видео xAI

Генерация задач видео xAI.

​
Создайте задачу видео и опрашивайте её

Используйте model ID с поддержкой видео со страницы Models или из каталога моделей. Примеры ниже создают задачу видео с помощью POST /v1/videos, а затем опрашивают возвращённый task ID, пока задача не достигнет terminal state.
В этих примерах используется заполнитель your-video-model-id. Замените его на доступный video model ID со страницы Models или из каталога моделей перед выполнением запроса.
Откройте Create и Query, чтобы использовать API playgrounds и схемы endpoints.
import os
import time
import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

create_response = requests.post(
    "https://api.cometapi.com/v1/videos",
    headers=headers,
    data={
        "model": "your-video-model-id",
        "prompt": "A calm camera move across a desk with a paper airplane",
    },
    timeout=30,
)
create_response.raise_for_status()
task = create_response.json()
task_id = task["id"]

terminal_statuses = {"completed", "failed", "error"}

while True:
    poll_response = requests.get(
        f"https://api.cometapi.com/v1/videos/{task_id}",
        headers=headers,
        timeout=30,
    )
    poll_response.raise_for_status()
    result = poll_response.json()
    print(result["status"], result.get("progress"))

    if result["status"] in terminal_statuses:
        print(result.get("video_url"))
        break

    time.sleep(10)

​
Примеры ответов

Успешный ответ на создание может выглядеть так. Сохраните task ID перед началом polling: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Успешный ответ polling может выглядеть так. Завершённые ответы могут включать video_url; некоторые форматы провайдеров используют поля результатов, специфичные для модели, или route содержимого видео, если такой route документирован: 
{
  "id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "completed",
  "progress": 100,
  "completed_at": 1779872300,
  "video_url": "https://example.com/generated-video.mp4"
}

​
Примеры записей моделей

Этот пример ответа каталога моделей показывает envelope /api/models и форму одной записи video model. Это не полный список моделей.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1767529753,
      "id": "your-video-model-id",
      "code": "your-video-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example video model",
      "model_type": "video",
      "features": [
        "text-to-video"
      ],
      "endpoints": "{\n  \"seedance\": {\n    \"path\": \"/v1/videos\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": null,
        "output": null,
        "per_request": null,
        "per_second": 0.024
      }
    }
  ]
}

​
Распространённые ошибки

Сохраняйте ID из ответа на создание перед выходом из обработчика вашей задачи.
Добавьте задержку и backoff между проверками статуса.
Используйте поля длительности и разрешения, документированные для выбранного video endpoint.
Рассматривайте video_url как необязательное поле и используйте как запасной вариант поля результатов, специфичные для модели, или content route, если он доступен.
Используйте polling как источник истины и убедитесь, что ваш callback URL принимает POST-запросы.

​
Коды ошибок и стратегия повторных попыток

Не повторяйте запрос, пока не будут исправлены поля prompt, files, duration или size.
Не повторяйте запрос, пока API key не будет указан и не станет валидным.
Проверьте task ID, base URL, path и model ID перед повторной попыткой.
Уменьшите размер загрузки перед повторной попыткой.
Повторяйте запрос с exponential backoff и уменьшите concurrency создания или polling.
Повторяйте создание задачи с backoff; продолжайте polling существующих задач, если только задача не достигла terminal error.
Примеры шаблонов реализации см. в Error codes and retry strategy, Rate limits and concurrency и Webhook and polling for video generation.

​
Цены и каталог моделей

Страница Models

Узнайте, как CometAPI показывает model IDs в документации.

Каталог моделей

Просматривайте доступность моделей и их возможности.

Цены

Проверьте цены перед вызовом модели.
Last modified on May 28, 2026