본문으로 건너뛰기

API 문서 · 작업

폴링 주기 권장 사항

백오프로 폴링하고 최종 상태에서 중지합니다.

Webhook을 설정하지 않았다면 조회 엔드포인트로 결과를 가져옵니다. 생성에는 보통 수십 초에서 몇 분이 걸립니다.

  • 첫 조회는 제출 후 약 5초 뒤에 하고, 이후 간격을 1.5배씩 늘려 최대 30초까지 늘립니다.
  • 상태가 succeeded 또는 failed가 되면 폴링을 멈춥니다.
  • 조회 요청은 과금되지 않지만 RPM 한도에는 포함됩니다. 작업이 많다면 GET /v1/videos/generations 목록 엔드포인트를 사용하세요.
  • Webhook을 설정했다면 조회는 보조 수단으로만 사용하세요. 예를 들어 콜백을 받지 못한 작업을 5분마다 한 번씩 조회합니다.
curl https://cn-api.aitoken.tools/v1/videos/generations/task_xxx \
  -H "Authorization: Bearer $AITOKEN_API_KEY"