API 문서 · 시작하기

빠른 시작

네 단계로 연동하고 첫 영상 작업을 제출하세요.

aitoken.tools는 하나의 플랫폼 API Key로 Seedance 영상 생성 기능을 제공합니다. API는 비동기 방식입니다. 작업을 제출하면 즉시 작업 ID가 반환되고, 생성이 끝나면 조회 또는 Webhook으로 결과를 받습니다. 연동은 네 단계면 충분합니다.

계정을 만들고 이메일을 인증합니다.
운영팀에 연락해 한도를 충전합니다. 오프라인으로 결제하면 운영팀이 결제 번호를 확인한 뒤 계정에 한도를 지급합니다.
콘솔 · API Key에서 Key를 만들고 tasks:create와 tasks:read 권한을 선택한 다음, 사용할 모델을 고릅니다.
POST /v1/videos/generations로 작업을 제출하고 GET /v1/videos/generations/{id}로 결과를 조회합니다.

Base URL

이 사이트(중국 사이트)의 API 주소는 https://cn-api.aitoken.tools/v1이며, 과금 통화는 CNY입니다. 중국 사이트와 글로벌 사이트는 계정, Key, 한도가 서로 분리되어 있으며 Key는 발급한 사이트에서만 사용할 수 있습니다.

첫 번째 작업

오른쪽 예제는 5초 길이, 720p 해상도의 텍스트-영상 생성 작업을 제출합니다. 응답으로 202 Accepted와 status가 queued인 작업 객체가 반환됩니다. billing.reserved_amount는 이번 작업에 예치된 한도 상한이며, 작업이 끝나면 실제 사용량으로 정산하고 차액을 돌려드립니다.

Idempotency-Key를 반드시 포함하세요

작업 생성 요청에는 Idempotency-Key 헤더가 필수입니다. 네트워크 타임아웃 후 같은 키로 재시도하면 작업이 중복 생성되거나 요금이 이중으로 차감되지 않습니다. 자세한 내용은 멱등성을 참고하세요.

다음 단계

첫 프레임, 참고 이미지 또는 참고 영상이 필요하면 먼저 에셋을 업로드하세요.
프로덕션 환경에서는 Webhook을 사용하고, 조회는 보조 수단으로 두세요.
오류 코드와 재시도 권장 사항을 확인하세요.

curl https://cn-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": "카메라가 천천히 다가간다, 새벽 안개 속 산골 마을",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'