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

Base URL và xác thực

Bearer Key, định dạng yêu cầu, quy ước ID và số tiền, phân trang.

Mọi endpoint /v1 đều dùng xác thực Bearer với header Authorization: Bearer sk-…. Máy chủ chỉ lưu giá trị băm của Key; Key đầy đủ chỉ hiển thị một lần khi tạo và không thể xem lại. Nếu làm mất, hãy thu hồi Key đó rồi tạo Key mới.

Base URL: https://cn-api.aitoken.tools/v1
Yêu cầu và phản hồi đều là JSON, tên trường dùng snake_case, thời gian theo RFC 3339 UTC, ví dụ 2026-10-30T03:30:00Z.
Số tiền là chuỗi có 6 chữ số thập phân, ví dụ "3.200000", và luôn đi kèm currency. Đừng chuyển sang số thực dấu phẩy động rồi mới tính toán.
ID công khai có tiền tố theo loại: task_, asset_, grp_, key_, evt_, req_.
Mọi phản hồi đều có X-Request-Id; hãy cung cấp giá trị này khi liên hệ đội ngũ vận hành để xử lý sự cố.

Danh sách và phân trang

Các endpoint danh sách dùng phân trang theo con trỏ (cursor): ?limit=20&after=<cursor>, phản hồi có dạng { data, has_more, next_cursor }. has_more bằng false nghĩa là đã đến trang cuối.

Không dùng Key trong trình duyệt hoặc ứng dụng phía client

Key có thể tiêu trực tiếp hạn mức của bạn. Chỉ gọi API từ máy chủ của chính bạn và nạp Key qua biến môi trường.

cURL

curl "https://cn-api.aitoken.tools/v1/videos/generations?limit=20" \
  -H "Authorization: Bearer $AITOKEN_API_KEY"

# Phản hồi
# { "data": [ ... ], "has_more": true, "next_cursor": "c_xxx" }

curl "https://cn-api.aitoken.tools/v1/videos/generations?limit=20&after=c_xxx" \
  -H "Authorization: Bearer $AITOKEN_API_KEY"