Skip to main content
GET
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
  • Query async video generation task execution status and results
  • Real-time status updates and progress tracking
  • Get generated videos when task completes
  • Multi-language support (zh/en/ko/ja)
All video generation tasks are executed asynchronously. After submitting a task, you need to query the status and results via the query endpoint.
요청 시 소재 심사를 사용하는 동영상 작업도 이 API로 조회합니다. queued에는 소재 준비와 심사 대기가 포함될 수 있으며, 작업 접수가 생성 시작을 뜻하지는 않습니다. 준비 기한은 기본 라운드당 20분이며 이후 동영상 생성 시간은 별도입니다. 실패 시 error.message를 확인하세요. 기존 소재 API를 따로 폴링할 필요는 없습니다.

Authorizations

string
필수
All endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Path 파라미터

string
필수
Task ID returned by the video generation API

응답

string
Unique task identifier
string
Object type, always generation.task
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task progress percentage (0-100)
string
Video generation model used
integer
Task creation time (Unix timestamp)
integer
Task completion time (Unix timestamp, only returned when completed)
integer
Video URL expiration time (Unix timestamp, only returned on completion)
object
Task result (only returned on success)
object
모델 도구 사용량입니다. Seedance 2에서 tools: [{ "type": "web_search" }]를 사용하면 usage.tool_usage.web_search에 실제 검색 횟수가 반환되며, 0은 검색하지 않았음을 의미합니다.
object
선택적인 플랫폼 청구 상태와 확정 금액입니다. status는 pending, settled, refunded 중 하나입니다. credits와 cost_usd는 10진수 문자열이며 순 청구 금액이 확정된 경우에만 반환됩니다. 객체가 없다고 해서 무료인 것은 아닙니다. 가격 및 실제 청구 금액을 참고하세요.
object
오류 information (only returned on failure)

Task 상태 Reference

Polling Strategy

Python Polling Example

Resource Expiration

Generated video URLs are valid for 24 hours
  • Please download and save videos within the validity period
  • expires_at field indicates video expiration time (Unix timestamp)
  • Expired videos cannot be accessed; to regenerate, submit a new task
  • Thumbnails expire simultaneously with videos

오류 Codes

Performance Tips

Video generation takes longer, recommendations:
  1. ToAPIs Task Webhook: Webhook을 기본으로, 조회를 대체 경로로 사용
  2. 조회 간격: 5~10초 이상과 지터. 429는 Retry-After를 읽고 지수 백오프
  3. Set Timeout: Long videos may take 5-10 minutes, set reasonable timeout
  4. Download Promptly: Videos expire after 24 hours, save to your storage immediately
비동기 작업 속도 제한을 참조하세요. 배치 조회는 최대 100개입니다.