Data Services

Asset Library

Seedance 2.x는 실제 사람처럼 보이는 참조 이미지·영상(AI 생성 가상 인물 포함)을 입력 단계에서 거부합니다. 그런 미디어를 에셋으로 등록하고 asset://<asset_id>로 참조하면 생성할 수 있습니다.

언제 필요한가요?

byteplus/bytedance/seedance-* 모델에 인물 이미지를 넣으면 다음 에러가 반환됩니다:

{"error_code": "content_policy_rejected",
 "error": "byteplus: The provider's content policy rejected this request. ..."}

등록 대상은 가상 인물(AI 생성)만입니다. 실존 인물·유명인·저작권 캐릭터를 닮은 이미지는 업스트림 심사에서 거부되며, 등록 크레딧은 자동 환불됩니다.

사용 흐름

1. 에셋 등록

curl -X POST https://api.core.today/v1/assets \
  -H "X-API-Key: cdt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "source_url": "https://example.com/virtual-host.png",
    "name": "host-1",
    "accept_terms": true
  }'

# → 202
# {"asset_id": "ast_3f9c2a1b7e6d4c05", "status": "processing", "preview_url": "…"}

accept_terms: true는 커스텀 에셋 업로드 약관(제9조의 2) 동의를 의미하며, 없으면 400 asset_terms_required로 거부됩니다.

2. active 대기 (보통 10초 내)

curl https://api.core.today/v1/assets/ast_3f9c2a1b7e6d4c05 -H "X-API-Key: cdt_YOUR_KEY"
# → {"status": "active", ...}   (3초 간격 폴링 권장)

3. 예측에서 참조

curl -X POST https://api.core.today/v1/predictions \
  -H "X-API-Key: cdt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/bytedance/seedance-2.5",
    "input": {
      "prompt": "[Image1]의 인물이 카메라를 보고 미소 짓는다",
      "reference_images": ["asset://ast_3f9c2a1b7e6d4c05"]
    }
  }'

프롬프트에서는 에셋을 [Image1], [Video1]처럼 타입+순번으로 지칭하세요(asset_id 직접 기재 금지). 첫 프레임(image)에 쓰면 aspect_ratio는 자동으로 adaptive 처리됩니다.

과금과 상태

등록 1건당 300 크레딧. 심사 거부(failed) 시 자동 환불되며, 같은 파일 재등록은 과금 없이 즉시 같은 사유로 거부됩니다.
팀당 등록 개수 제한은 없습니다.
플랫폼 전체 슬롯이 차면 가장 오래 사용되지 않은 에셋이 evicted(잠시 내려감, 삭제 아님) 상태가 되고, 다음 사용 시 자동으로 다시 등록됩니다(~10초, 무료).
등록 성공 ≠ 생성 성공 보장 — 출력 모더레이션(저작권 캐릭터·유명인 닮음)은 별도로 동작하며, 그 실패는 일반 예측처럼 환불됩니다.

상태	의미
processing	업스트림 심사 중 (~10초)
active	사용 가능
evicted	슬롯 부족으로 잠시 내려감 — 다음 사용 시 자동 복구(무료)
failed	심사 거부 — failure_reason에 사유, 크레딧 환불됨

미디어 제약

이미지: jpeg / png / webp / gif / bmp / tiff / heic · 변 300~6000px · 종횡비 0.4~2.5 · 30MB 이하
영상: mp4 / mov / webm · 오디오: mp3 / wav / m4a / aac / ogg / flac · 30MB 이하
인물 권장 구도: 세로, 정면 전신 1장 + 어깨 위 무표정 클로즈업(얼굴이 프레임의 2/3) 1장

엔드포인트

메서드 / 경로	설명
POST /v1/assets	등록 (202, accept_terms 필수)
GET /v1/assets	목록 (?status=processing\|active\|evicted\|failed)
GET /v1/assets/{id}	단건 조회 (preview_url 포함 — 1시간 서명 썸네일)
DELETE /v1/assets/{id}	삭제 (204)

리셀러 팀은 예측과 동일하게 X-Customer-Id가 필수이며, 에셋은 해당 고객에게 귀속됩니다(다른 고객의 에셋은 404). 자세한 내용은 End-Customer Budgets 문서를 참고하세요.

콘솔에서 사용하기

팀 워크스페이스의 에셋 메뉴에서 등록·조회·삭제할 수 있습니다.
Seedance 모델 상세의 이미지 필드에는 Assets 탭이 있어 등록된 에셋을 바로 선택할 수 있고, 인물 이미지를 업로드하면 사전 감지 배지가 등록을 안내합니다.
실행이 인물 정책으로 거부되면 결과 패널에서 원클릭으로 에셋 등록 후 재실행할 수 있습니다.