Skip to main content
POST

인증

string
필수
모든 요청에 Bearer Token 인증이 필요합니다API Key 발급:API Key 관리 페이지에서 API Key를 발급받으세요각 요청에 다음 헤더를 추가하세요:

요청 파라미터

object
에셋 그룹 정보group_id를 지정하지 않으면 서버가 이 필드를 기반으로 AIGC 타입 에셋 그룹을 자동 생성합니다예시:
group_id와 동시에 사용할 수 없습니다. 둘 중 하나만 지정하세요
string
기존 에셋 그룹 ID지정 시 그룹 생성을 건너뛰고 해당 그룹에 직접 에셋을 제출합니다
group과 동시에 사용할 수 없습니다. 둘 중 하나만 지정하세요
string
기본값:"default"
프로젝트 이름기본값: default
string
기본값:"Image"
에셋 타입선택 값:
  • Image - 이미지 에셋 (기본값)
  • Video - 동영상 에셋
  • Audio - 오디오 에셋
기본값: Image
array
에셋 목록, 1회 요청으로 여러 에셋 제출 가능
1회 제출 최대 20
예시:
string
단일 에셋 단축 표기: 에셋 URL
assets 배열과 둘 중 하나만 사용 가능. 에셋 1개 제출 시 적합합니다
string
단일 에셋 단축 표기: 에셋 이름
assets 배열과 둘 중 하나만 사용 가능. 에셋 1개 제출 시 적합합니다

응답

integer
응답 상태 코드, 성공 시 200
object
태스크 정보

사용 예시

예시 1: 배치 제출 (그룹 자동 생성)

group_id를 지정하지 않으면 서버가 AIGC 타입 에셋 그룹을 자동 생성한 후 제출합니다.

예시 2: 기존 그룹에 에셋 추가

group_id를 지정하여 그룹 생성을 건너뛰고 직접 제출합니다.

예시 3: 단일 에셋 단축 표기

에셋이 1개인 경우 최상위 urlname 필드를 직접 사용할 수 있습니다.

심사 결과 조회

에셋 제출 후 비동기 심사 태스크가 됩니다. 태스크 상태 조회 엔드포인트로 진행 상황을 확인하세요:

전체 승인

일부 실패

배치 제출 시 1개라도 심사에 실패하면 태스크 상태가 failed가 됩니다. 승인된 에셋은 계속 사용 가능하며 result.usable_assets에 표시됩니다.
  • result.usable_assets[].asset_url은 Seedance 2.0 동영상 생성에 직접 사용할 수 있습니다
  • result.failed_assets 내 에셋은 소스 파일을 교체하거나 재제출해야 합니다
  • 단일 에셋 태스크도 호환을 위해 result.asset_url을 반환합니다

심사 통과 에셋 사용

asset://... URL을 Seedance 2.0 동영상 생성 엔드포인트에 직접 전달하세요:
서버가 asset:// 접두사를 감지하면 에셋 심사를 다시 트리거하지 않고 직접 생성 태스크를 제출합니다.