API 문서 · 시작하기

Base URL 및 인증

Bearer Key, 요청 형식, ID 및 금액 규칙, 페이지네이션.

모든 /v1 엔드포인트는 Bearer 인증을 사용하며, 헤더 형식은 Authorization: Bearer sk-…입니다. 서버에는 Key의 해시만 저장됩니다. 전체 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는 자체 서버에서만 호출하고, Key는 환경 변수로 주입하세요.

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"