Skip to main content

​
소개

Seedance 2.0은 텍스트-투-비디오, 이미지-투-비디오(첫/마지막 프레임), 멀티모달 참조 생성, 얼굴 일관성 자산 라이브러리를 지원합니다. Gravitex AI 게이트웨이를 통해 통합 호출, Base URL: https://api.gravitex.ai.

​
인증

모든 엔드포인트: Authorization: Bearer sk-xxxxxxxxxx, Content-Type: application/json.
각 asset://를 자산 asset_type에 따라 image_url, video_url, audio_url에 매핑하세요—모두 image_url에 넣지 마세요. 자산은 공개 https URL로만 생성할 수 있습니다(Base64 / Data URI 미지원).

​
자산 라이브러리 유형

권장 흐름: 자산 그룹 생성 → 자산 생성 → status: active까지 폴링 → 비디오 생성 작업 생성 → 비디오 생성 작업 조회.

​
엔드포인트

​
비디오 생성

비디오 생성 작업 생성

POST /v1/video/generations

비디오 생성 작업 조회

GET /v1/video/generations/

검수 차단 사유 조회

GET /v1/video/generations/moderation-result/

​
자산 라이브러리 (aigc)

자산 그룹 생성

POST /v1/asset-groups

자산 그룹 목록 조회

GET /v1/asset-groups

자산 그룹 삭제

DELETE /v1/asset-groups/

자산 생성

POST /v1/assets

자산 목록 조회

GET /v1/assets

자산 조회

GET /v1/assets/

자산 삭제

DELETE /v1/assets/

​
실인물 얼굴 (liveness_face)

자산 그룹 생성(실인물)

POST /v1/visual-validate/session
POST /v1/visual-validate/result는 H5 콜백 페이지 전용입니다. 애플리케이션에서 직접 호출하지 마세요.

​
권장 흐름

  1. (선택) 자산 그룹 생성 → 자산 생성 → status: active까지 폴링(보통 1~3분)
  2. POST /v1/video/generations
  3. GET /v1/video/generations/{task_id} 약 5초마다 completed까지 폴링(보통 30~120초)
  4. 검수 failed 시 검수 차단 사유 조회 참조
비디오 작업 제출도 참고하세요.

​
일반적인 HTTP 상태 코드

게이트웨이 검증 오류는 error.type: invalid_request_error를 사용합니다. BytePlus 오류는 error.code(예: InvalidParameter)와 param 필드 경로와 함께 전달됩니다.