Skip to main content

​
소개

Seedance 공식 미러 API는 BytePlus Ark Seedance 공식 인터페이스와 요청 본문 및 응답 본문이 완전히 동일하며, Base URL과 인증 방식만 다릅니다. 기존 공식 SDK 호출 코드는 base_url과 Authorization만 변경하면 연동할 수 있습니다. Base URL: https://api.gravitex.ai
이것은 플랫폼 간소화 인터페이스(/v1/video/generations, /v1/assets 등)와는 별도의 독립 인터페이스입니다. 자산 라이브러리 데이터는 공유되지만, 비디오 작업 라우팅은 서로 간섭하지 않습니다.

​
인증

모든 인터페이스: Authorization: Bearer sk-{your_token_key}, Content-Type: application/json.

​
자산 라이브러리 유형

권장 흐름: 자산 그룹 생성 → CreateAsset → Status: Active까지 폴링 → 작업 생성 → 작업 조회.

​
엔드포인트 목록

​
비디오 생성 작업

작업 생성

POST /api/v3/contents/generations/tasks

작업 조회

GET /api/v3/contents/generations/tasks/

작업 취소/삭제

DELETE /api/v3/contents/generations/tasks/

​
자산 라이브러리 (통합 봉투 Action)

모든 자산 라이브러리 작업은 동일한 엔드포인트를 사용하며, Action 쿼리 매개변수로 구분합니다:
응답은 { ResponseMetadata, Result } 봉투 형식입니다(실인물 검증 두 Action 제외, 평면 구조).

CreateAssetGroup

자산 그룹 생성 (AIGC 강제)

CreateAsset

자산 생성

ListAssetGroups

자산 그룹 목록 조회

ListAssets

자산 목록 조회

GetAsset

단일 자산 조회

GetAssetGroup

단일 자산 그룹 조회

UpdateAsset

자산 업데이트 (Name)

UpdateAssetGroup

자산 그룹 업데이트 (Name/Description)

DeleteAsset

자산 삭제

DeleteAssetGroup

자산 그룹 삭제 (연쇄)

​
실인물 자산 라이브러리 (LivenessFace)

CreateVisualValidateSession

실인물 검증 세션 시작

GetVisualValidateResult

검증 결과 조회 및 자산 그룹 생성

​
권장 흐름

  1. (선택) CreateAssetGroup → CreateAsset → Status: Active까지 폴링
  2. POST /api/v3/contents/generations/tasks로 작업 제출
  3. GET /api/v3/contents/generations/tasks/{id}로 succeeded까지 폴링
  4. 필요 시 DELETE로 대기 중 작업 취소 또는 완료된 기록 정리

​
오류 처리

자산 라이브러리 오류는 봉투 ResponseMetadata.Error.{Code,Message}를 통해 반환됩니다: 비디오 생성 작업 API 오류는 해당 업스트림 상태 코드와 오류 본문을 반환합니다.