미디어 입력
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
생성 실행 요청은 라이브 OpenAPI 스키마가 보여주는 필드에 공개 HTTPS URL 형태로 미디어를 받습니다. 일반적인 Avatar 1.0, Avatar Video, 페이스 스왑, 캡션 요청을 제출하기 전에 별도의 Sume 에셋을 만들 필요는 없습니다.
입력 URL 필드
| 워크플로 | 필드 | 용도 |
|---|---|---|
| Avatar 1.0 사진 입력 | input.image_url | input.type: "photo"를 위한 레퍼런스 사진입니다. |
| Avatar Video 제품 분기 | product_image | 선택 사항인 제품·레퍼런스 이미지입니다. |
| Avatar Video 장면 사진 분기 | scene.image_url | scene.type: "photo"일 때의 선택 장면 레퍼런스입니다. |
| Avatar Video 장면 배경 이미지 | video_inputs[].background.url | background.type: "image"일 때 장면별 이미지 배경입니다. |
| 페이스 스왑 (Beta) | video_url | 페이스 스왑용 공개 HTTPS 소스 비디오입니다. |
| 비디오 캡션 | video_url | 캡션을 넣을 공개 HTTPS 소스 비디오입니다. |
입력 이미지·비디오 URL은 가져올 수 있는 공개 HTTPS URL이어야 합니다. localhost, 사설 네트워크 URL, HTTPS가 아닌 URL, 서명된·비공개 URL, 콘텐츠 타입이 맞지 않는 URL은 생성 제출 전에 거부됩니다.
Avatar 사진 예제
input.type: "photo"와 공개 HTTPS image_url을 함께 사용하세요(아래 필드는
필요에 맞게 수정하세요).
Create an Avatar 1.0 identity
POST /v1/avatar-1.0/generate
Required
Avatar Video 제품 예제
Create an avatar talking video
POST /v1/avatar-1.0/talking-video
Required
OpenAPI 기본값 **plus**를 쓰려면 quality를 생략하세요.
페이스 스왑 소스 비디오 예제
Create a face-swap job (Beta)
POST /v1/models/sume/avatar-face-swap/v1.0/runs
Required
생성된 산출물
완료된 Job에는 산출물 객체가 포함될 수 있습니다.
Sume는 생성 결과를 공개 결과로 노출하기 전에 Sume 소유 미디어 URL로 미러링합니다. 연동에서는 원본 프로바이더 URL이 아니라 Sume URL을 저장해야 합니다. 서명된 업로드·다운로드 URL과 비공개 오브젝트 키는 실행 공개 API 계약에 포함되지 않습니다.
트렌딩 비디오는 리서치용 공개 시청 URL을 반환하며, MVP에서는 내려받을 수 있는 원본 파일을 미러링하지 않습니다.