Skip to main content

개요

이 엔드포인트는 Volc 스타일 Seedance 작업 구조를 이미 사용하는 팀을 위한 것입니다. 인증은 TokenLab Bearer API Key를 사용합니다. 반환되는 작업 ID는 cgt-로 시작하며, statussucceeded, failed, cancelled, expired 중 하나가 될 때까지 폴링하세요. 공식 작업 계약은 /api/v3/contents/generations/tasks 아래의 REST 경로를 사용합니다. 기존 Action 별칭은 이전 TokenLab 통합을 위해서만 유지되며 공식 와이어 호환 계약에는 포함되지 않습니다. callback_url에는 공개 HTTP(S) 주소를 지정할 수 있습니다. queued, running, succeeded, failed, expired로 상태가 바뀔 때마다 조회 API와 동일한 객체를 TokenLab 전용 헤더 없이 보냅니다. succeededfailed는 5초 후 최대 세 번 재시도합니다.
연결이 끊긴 뒤 중복 없이 복구하려면 REST 생성 요청에 고유한 Idempotency-Key를 보내세요. 같은 body와 key로 재시도하면 같은 cgt-... ID를 반환하고, 같은 key를 다른 body에 사용하면 409를 반환합니다. 기존 Action 경로에는 적용되지 않습니다.
같이 보기 Seedance 2.0 비디오 모델비디오 생성.

콘텐츠 규칙

  • 프롬프트 텍스트에는 type=text를 사용합니다.
  • role 없는 type=image_url은 첫 프레임으로 처리되며, role=first_frame을 명시할 수도 있습니다.
  • role=last_frame은 첫 프레임과 함께만 사용할 수 있습니다.
  • 참조 미디어에는 role=reference_image, reference_video, reference_audio를 사용합니다.
  • 하나의 요청에서 첫/마지막 프레임 입력과 참조 미디어를 섞지 마세요.

파라미터 참고

  • ratio16: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 항목은 무시하지 않고 거부합니다.

예시