---
title: 미디어 입력
description: 공개 HTTPS 미디어 입력을 사용하고 Sume 자사 산출물을 소비하는 방법을 살펴보세요.
---

생성 실행 요청은 라이브 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`을 함께 사용하세요(아래 필드는
필요에 맞게 수정하세요).

<!-- api-call-example:avatar-generate -->

## Avatar Video 제품 예제

<!-- api-call-example:avatar-talking-video -->

OpenAPI 기본값 **`plus`**를 쓰려면 `quality`를 생략하세요.

## 페이스 스왑 소스 비디오 예제

<!-- api-call-example:face-swap-run -->

## 생성된 산출물

완료된 Job에는 산출물 객체가 포함될 수 있습니다.

```json
{
  "id": "artifact_...",
  "url": "https://media.sume.com/artifacts/...",
  "media_type": "image",
  "content_type": "image/png"
}
```

Sume는 생성 결과를 공개 결과로 노출하기 전에 Sume 소유 미디어 URL로
미러링합니다. 연동에서는 원본 프로바이더 URL이 아니라 Sume URL을 저장해야
합니다. 서명된 업로드·다운로드 URL과 비공개 오브젝트 키는 실행 공개 API 계약에
포함되지 않습니다.

[트렌딩 비디오](/models/trending-videos)는 리서치용 공개 시청 URL을 반환하며,
MVP에서는 내려받을 수 있는 원본 파일을 미러링하지 않습니다.