비디오 자산 생성

가용성

이 페이지는 Modelflare 자산 관리 경로를 문서화합니다. 호출에는 유효한 스마트 API 키 또는 미디어 그룹 API 키, 사용 가능한 미디어 채널 및 필수 권한이 필요합니다.

엔드포인트

POST https://modelflare.dev/volc/asset/CreateAsset

인증

Modelflare API 키를 사용하세요.

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

생성, 업데이트 및 삭제 요청과 함께 Idempotency-Key을 보냅니다. 동일한 사용자에 대해 동일한 키를 다시 시도하면 변형을 반복하지 않고 저장된 응답이 재생됩니다.

요청

기존 그룹에 동영상을 추가합니다. 반환된 ID는 처리 후 지원되는 Seedance 워크플로에서 사용될 수 있습니다.

필드	유형	필수	설명	예시
`GroupId`	`string`	예	대상 자산 그룹 ID입니다.	`group-20260320141746-zsf6b`
`AssetType`	`Video`	예	는 `Video`이어야 합니다.	`Video`
`URL`	`string`	예	공개 동영상 URL입니다. 비디오 Base64는 허용되지 않습니다. MP4 또는 MOV를 사용하세요. 2~~30초, 24~~60FPS, 각 측면에서 300~~6000px, 가로세로 비율 0.4~~2.5, 480p/720p/1080p/4K, 총 픽셀 407696~2086876, 200MB 이하.	`https://example.com/video.mp4`
`file`	`binary`	아니요	동일한 비디오 제약 조건을 갖는 `URL`에 대한 멀티파트 대안입니다.	`video.mp4`
`Name`	`string`	아니요	표시/검색 이름, 최대 64자.	`scene-clip`
`model`	`string`	예		`volc-asset-video`
`ProjectName`	`string`	아니요	프로젝트 이름. 대상 그룹과 일치해야 합니다. 기본값은 `default`입니다.	`default`

JSON 예:

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

다중 부분/양식 데이터 예:

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

응답

영상이 비동기 처리에 들어갔습니다. Status이 Active 또는 Failed이 될 때까지 GetAsset을 폴링합니다. 업로드 시간 SLA는 없습니다. 일반적인 동영상은 약 9~~12초가 소요되는 반면 바쁜 검토 대기열은 대략 10초~~2분 정도 소요됩니다.

필드	유형	필수	설명	예시
`Id`	`string`	예	자산 ID. 상태가 `Active`인 후에만 `asset://<ID>`을 사용하십시오.	`asset-20260528140922-d9646`

응답 예시:

{
  "Id": "asset-20260528140922-d9646"
}

오류

상태	의미
`400`	요청이 잘못되었습니다.
`401`	API 키가 누락되었거나 승인되지 않았습니다.

오류 본문 예(반환된 경우):

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

이미지, 비디오 및 오디오 생성은 비동기식입니다. 자산 ID를 받은 후 GetAsset을 호출하고 상태가 Active인 경우에만 asset://<ID> 참조를 사용하십시오.