개요
이 엔드포인트는 Volc 스타일 Seedance 작업 구조를 이미 사용하는 팀을 위한 것입니다. 인증은 TokenLab Bearer API Key를 사용합니다. 반환되는 작업 ID는cgt-로 시작하며, status가 succeeded, failed, cancelled, expired 중 하나가 될 때까지 폴링하세요.
공식 작업 계약은 /api/v3/contents/generations/tasks 아래의 REST 경로를 사용합니다. 기존 Action 별칭은 이전 TokenLab 통합을 위해서만 유지되며 공식 와이어 호환 계약에는 포함되지 않습니다.
callback_url에는 공개 HTTP(S) 주소를 지정할 수 있습니다. queued, running, succeeded, failed, expired로 상태가 바뀔 때마다 조회 API와 동일한 객체를 TokenLab 전용 헤더 없이 보냅니다. succeeded와 failed는 5초 후 최대 세 번 재시도합니다.
연결이 끊긴 뒤 중복 없이 복구하려면 REST 생성 요청에 고유한
Idempotency-Key를 보내세요. 같은 body와 key로 재시도하면 같은 cgt-... ID를 반환하고, 같은 key를 다른 body에 사용하면 409를 반환합니다. 기존 Action 경로에는 적용되지 않습니다.콘텐츠 규칙
- 프롬프트 텍스트에는
type=text를 사용합니다. role없는type=image_url은 첫 프레임으로 처리되며,role=first_frame을 명시할 수도 있습니다.role=last_frame은 첫 프레임과 함께만 사용할 수 있습니다.- 참조 미디어에는
role=reference_image,reference_video,reference_audio를 사용합니다. - 하나의 요청에서 첫/마지막 프레임 입력과 참조 미디어를 섞지 마세요.
파라미터 참고
ratio는16:9,4:3,1:1,3:4,9:16,21:9,adaptive를 허용합니다.generate_audio의 공식 기본값은false입니다. 동기화된 오디오가 필요하면true를 전달하세요.service_tier=default는 허용됩니다. Seedance 2.0 호환 작업은service_tier=flex,frames,camera_fixed=true를 거부합니다.- 선택한 모델이 지원할 때
tools에는{ "type": "web_search" }같은 객체를 전달할 수 있습니다. 잘못된 tool 항목은 무시하지 않고 거부합니다.