동영상 작업에서 소재 심사하기

​

요청 보내기

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "client_business_id": "avatar-demo-001",
    "prompt": "Animate the character in image 1 using the movement in video 1.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://files.example.com/avatar.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://files.example.com/motion.mp4", "role": "reference_video"}
    ],
    "private_asset_review": true
  }'

​

결과 기다리기

1. 요청이 접수되면 동영상 작업을 반환합니다. 심사가 끝날 때까지 HTTP 연결을 유지하지 않습니다. 작업 접수는 심사 통과나 동영상 생성 시작을 의미하지 않습니다.
2. 소재 라이브러리를 지원하는 채널에서는 재사용 가능한 기록을 확인합니다. 기록이 없으면 소재를 저장하고 채널별 소재마다 독립 그룹을 자동 생성한 뒤 심사를 요청합니다. 동일 사용자, 소재 출처, 채널의 동시 요청은 준비 과정을 공유하므로 그룹 생성이나 심사를 중복 수행하지 않습니다.
3. 이번 라운드에서 심사가 필요한 모든 소재가 통과해야 동영상 생성을 제출합니다. 최초 준비에는 몇 분이 걸릴 수 있으며 사용 가능한 기록이 있으면 재심사를 건너뜁니다. 소재 라이브러리를 지원하지 않는 채널은 기존 미디어 처리 및 생성 흐름을 사용하며 이 기능을 위한 소재 사본이나 그룹을 만들지 않습니다. 동영상 생성은 계속 비동기로 진행됩니다.

curl --request GET \
  --url https://toapis.com/v1/videos/generations/avatar-demo-001 \
  --header 'Authorization: Bearer YOUR_API_KEY'

​

재사용, 재시도, 보관 기간

• 다음 요청에도 소재와 private_asset_review: true를 보냅니다. 소재 ID를 저장할 필요는 없습니다. 심사가 필요한 채널에서는 같은 사용자와 채널 안에서 URL은 전체 주소로, Base64 이미지는 디코딩한 내용의 해시로 비교합니다. 같은 바이트의 순수 Base64와 data URI는 같은 기록을 재사용합니다. 사용자나 채널 간에는 공유하지 않습니다.
• 다른 URL은 새 출처로 처리됩니다. 동일 URL의 내용 변경을 파일 내용으로 감지하지 않으므로, 파일을 바꿀 때는 버전이 다른 URL을 사용하세요.
• 심사가 필요하면 채널마다 독립된 사본을 저장합니다. 현재 기본 정리 기준은 60일 동안 미사용이며 실제 보관 기간은 설정에 따릅니다. 자동 생성된 그룹은 소재 사본과 함께 정리하며, 기존 API의 소재나 공유 그룹은 이 정리 대상에 포함하지 않습니다. 동영상 제출이 수락되면 사용으로 간주하며 최종 완료까지 기다리지 않습니다. 정리 후에는 다시 준비하므로 원본 URL의 접근 가능 상태를 유지하세요.
• 같은 업무 요청의 네트워크 재시도에는 같은 client_business_id를 사용하세요. 기존 작업을 반환하며 새 동영상 작업을 만들지 않습니다. 다른 동영상이나 실패 후 새 시도에는 새로운 업무 ID를 사용합니다. 심사가 오래 걸린다는 이유로 작업을 반복 생성하지 마세요.
• 동영상 제출 여부가 아직 확인되지 않았다면 원래 작업을 계속 조회하거나 지원팀에 문의하세요. 곧바로 새 업무 ID로 다시 보내지 마세요.

​

기존 소재 API와 함께 사용하기