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

​

요청 보내기

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. 플랫폼이 소재 사본을 저장하고 선택된 채널에 사용 가능한 심사 기록이 있는지 확인합니다. 필요할 때만 심사를 시작합니다. 동일 사용자, URL, 채널의 동시 요청은 준비 과정을 공유합니다.
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을 사용하세요.
• 플랫폼은 독립된 사본을 저장합니다. 기본적으로 30일 넘게 사용하지 않은 사본은 정리될 수 있으며 실제 보관 기간은 설정에 따릅니다. 동영상 제출이 수락되면 사용으로 간주하며 최종 완료까지 기다리지 않습니다. 정리 후 요청하면 다시 준비하므로 원본 URL의 접근 가능 상태를 유지하세요.
• 같은 업무 요청의 네트워크 재시도에는 같은 client_business_id를 사용하세요. 기존 작업을 반환하며 새 동영상 작업을 만들지 않습니다. 다른 동영상이나 실패 후 새 시도에는 새로운 업무 ID를 사용합니다. 심사가 오래 걸린다는 이유로 작업을 반복 생성하지 마세요.
• 동영상 제출 여부가 아직 확인되지 않았다면 원래 작업을 계속 조회하거나 지원팀에 문의하세요. 곧바로 새 업무 ID로 다시 보내지 마세요.

​

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