API 文档 · 入门

Base URL 与鉴权

Bearer Key、请求格式、ID 与金额约定、分页。

所有 /v1 接口使用 Bearer 鉴权，请求头格式为 Authorization: Bearer sk-…。Key 只在服务端保存哈希，创建时完整显示一次，之后无法再次查看；遗失请撤销后重建。

Base URL：https://cn-api.aitoken.tools/v1
请求与响应均为 JSON，字段使用 snake_case，时间为 RFC 3339 UTC，例如 2026-10-30T03:30:00Z。
金额是 6 位小数的字符串，例如 "3.200000"，并始终带 currency。不要用浮点数解析后再计算。
对外 ID 带类型前缀：task_、asset_、grp_、key_、evt_、req_。
每个响应都带 X-Request-Id，联系运营排查问题时请提供它。

列表与分页

列表接口使用游标分页：?limit=20&after=<cursor>，响应为 { data, has_more, next_cursor }。has_more 为 false 时表示已到末页。

不要在浏览器或客户端里使用 Key

Key 能直接消耗你的额度。只在你自己的服务端调用 API，并通过环境变量注入。

cURL

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

# 响应
# { "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"