Chuyển đến nội dung chính

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.

Sử dụng tài liệu model video của CometAPI bằng cách chọn quy trình nhà cung cấp phù hợp với loại công việc của bạn. Hầu hết endpoint video tạo các tác vụ bất đồng bộ, vì vậy hãy lưu task ID và dùng polling để lấy kết quả. Chỉ thêm callback khi trang dành riêng cho model có tài liệu về hỗ trợ callback.

​
Chọn một video API

Tạo video Sora

Tạo tác vụ video Sora.

Lấy video Sora

Truy vấn tác vụ video Sora.

Runway image to video

Tạo video Runway từ hình ảnh.

Kling text to video

Tạo video Kling từ Prompt văn bản.

Tạo Seedance

Tạo tác vụ video Seedance.

Tạo video xAI

Tạo tác vụ video xAI.

​
Tạo và poll một tác vụ video

Sử dụng model ID có khả năng xử lý video từ trang Models hoặc thư mục model. Các ví dụ bên dưới tạo một tác vụ video với POST /v1/videos, sau đó poll task ID được trả về cho đến khi tác vụ đạt trạng thái kết thúc.
Các ví dụ này dùng placeholder your-video-model-id. Hãy thay thế bằng một model ID video khả dụng từ trang Models hoặc thư mục model trước khi chạy yêu cầu.
Mở Create và Query để sử dụng playground API và schema 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)

​
Ví dụ phản hồi

Một phản hồi tạo thành công có thể trông như sau. Hãy lưu task ID trước khi poll: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Một phản hồi polling thành công có thể trông như sau. Phản hồi completed có thể bao gồm video_url; một số định dạng nhà cung cấp dùng các trường kết quả dành riêng cho model hoặc route nội dung video khi route đó có tài liệu: 
{
  "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"
}

​
Bản ghi model mẫu

Phản hồi danh mục model mẫu này hiển thị envelope /api/models và hình dạng của một bản ghi model video. Đây không phải là danh sách model đầy đủ.
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
      }
    }
  ]
}

​
Các lỗi thường gặp

Lưu ID từ phản hồi tạo trước khi trả về từ trình xử lý job của bạn.
Thêm độ trễ và backoff giữa các lần kiểm tra trạng thái.
Sử dụng các trường thời lượng và độ phân giải được ghi trong tài liệu cho endpoint video đã chọn.
Xem video_url là tùy chọn và fallback sang các trường kết quả dành riêng cho model hoặc route nội dung khi có sẵn.
Dùng polling làm nguồn dữ liệu đáng tin cậy và xác minh rằng URL callback của bạn chấp nhận yêu cầu POST.

​
Mã lỗi và chiến lược retry

Không retry cho đến khi các trường prompt, tệp, thời lượng hoặc kích thước được sửa đúng.
Không retry cho đến khi API key tồn tại và hợp lệ.
Kiểm tra task ID, URL cơ sở, path và model ID trước khi retry.
Giảm kích thước tải lên trước khi retry.
Retry với exponential backoff và giảm mức độ đồng thời khi tạo hoặc polling.
Retry việc tạo tác vụ với backoff; tiếp tục polling các tác vụ hiện có trừ khi tác vụ đạt lỗi kết thúc.
Để tham khảo các mẫu triển khai, xem Mã lỗi và chiến lược retry, Giới hạn tốc độ và mức độ đồng thời, và Webhook và polling cho việc tạo video.

​
Giá và thư mục model

Trang Models

Tìm hiểu cách CometAPI hiển thị model ID trong tài liệu.

Thư mục model

Xem các model khả dụng và khả năng của chúng.

Giá

Kiểm tra giá trước khi gọi một model.
Last modified on May 28, 2026