Перейти до основного вмісту

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.

Використовуйте документацію з відеомоделей CometAPI, обираючи workflow постачальника, який відповідає типу вашої задачі. Більшість відеокінцевих точок створюють асинхронні задачі, тому збережіть task ID і використовуйте polling для отримання результатів. Додавайте callbacks лише тоді, коли на сторінці конкретної моделі документовано підтримку callbacks.

​
Оберіть відео API

Create Sora video

Створюйте задачі для Sora video.

Retrieve Sora video

Виконуйте запити до задач Sora video.

Runway image to video

Створюйте відео Runway з зображень.

Kling text to video

Створюйте відео Kling із текстових prompt.

Seedance create

Створюйте відеозадачі Seedance.

xAI video generation

Створюйте відеозадачі xAI.

​
Створіть і опитуйте відеозадачу

Використовуйте model ID, сумісний із відео, зі сторінки Models або каталогу моделей. Наведені нижче приклади створюють відеозадачу за допомогою POST /v1/videos, а потім виконують polling повернутого task ID, доки задача не досягне terminal state.
У цих прикладах використано placeholder your-video-model-id. Замініть його на доступний model ID для відео зі сторінки Models або каталогу моделей перед виконанням запиту.
Відкрийте Create і Query, щоб використовувати API playgrounds і схеми endpoint.
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)

​
Приклади відповідей

Успішна create response може мати такий вигляд. Збережіть 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 response може мати такий вигляд. У completed responses може бути video_url; деякі формати постачальників використовують model-specific result fields або content 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 і один формат запису відеомоделі. Це не повний список моделей.
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 з create response перед поверненням із вашого job handler.
Додайте затримку та backoff між status checks.
Використовуйте поля duration і resolution, документовані для вибраної відеокінцевої точки.
Розглядайте video_url як необов’язковий і переходьте до model-specific result fields або content route, коли вони доступні.
Використовуйте polling як джерело істини та переконайтеся, що ваш callback URL приймає запити POST.

​
Коди помилок і стратегія повторних спроб

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

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

Сторінка Models

Дізнайтеся, як CometAPI показує model ID у документації.

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

Перегляньте доступність і можливості моделей.

Ціни

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