Tài liệu API · Bắt đầu

Bắt đầu nhanh

Tích hợp trong bốn bước và gửi tác vụ video đầu tiên.

aitoken.tools cung cấp khả năng tạo video Seedance thông qua một API Key duy nhất của nền tảng. API hoạt động bất đồng bộ: khi gửi tác vụ, bạn nhận ngay mã tác vụ (task ID); khi tạo xong, bạn lấy kết quả bằng cách truy vấn hoặc qua Webhook. Toàn bộ quy trình chỉ gồm bốn bước:

Đăng ký tài khoản và xác minh email.
Nạp hạn mức: tự nạp bằng tiền mã hóa tại Bảng điều khiển · Hạn mức và hóa đơn, hoặc liên hệ đội ngũ vận hành để thanh toán ngoại tuyến.
Tạo Key tại Bảng điều khiển · API Key, chọn các quyền tasks:create và tasks:read, rồi chọn các mô hình bạn muốn dùng.
Gọi POST /v1/videos/generations để gửi tác vụ, sau đó dùng GET /v1/videos/generations/{id} để truy vấn kết quả.

Base URL

Địa chỉ API của trạm này (Trạm quốc tế) là https://api.aitoken.tools/v1, đơn vị tiền tệ tính phí là USD. Tài khoản, Key và hạn mức của trạm Trung Quốc và trạm quốc tế hoàn toàn tách biệt; Key chỉ gọi được trạm đã cấp nó.

Tác vụ đầu tiên

Ví dụ bên cạnh gửi một tác vụ tạo video từ văn bản dài 5 giây, độ phân giải 720p. API trả về 202 Accepted cùng đối tượng tác vụ có status là queued. billing.reserved_amount là mức hạn mức tối đa bị tạm giữ cho lần này; khi tác vụ kết thúc, hệ thống quyết toán theo mức dùng thực tế và hoàn lại phần chênh lệch.

Luôn gửi kèm Idempotency-Key

Yêu cầu tạo tác vụ bắt buộc phải có header Idempotency-Key. Khi mạng hết thời gian chờ, hãy thử lại với cùng một khóa: tác vụ sẽ không bị tạo trùng và bạn không bị trừ phí hai lần. Xem thêm Tính lũy đẳng.

Bước tiếp theo

Nếu cần khung hình đầu, ảnh tham chiếu hoặc video tham chiếu, hãy tải lên tài nguyên trước.
Trong môi trường production, nên dùng Webhook và để truy vấn làm phương án dự phòng.
Tìm hiểu mã lỗi và khuyến nghị thử lại.

curl https://api.aitoken.tools/v1/videos/generations \
  -H "Authorization: Bearer $AITOKEN_API_KEY" \
  -H "Idempotency-Key: order-A1001-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-standard",
    "prompt": "Máy quay từ từ tiến vào thị trấn núi trong sương sớm",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'