---
title: 레시피
description: 자주 쓰는 Sume API 워크플로를 위한 현재 플랫폼 기준의 짧은 레시피를 살펴보세요.
---

이 페이지는 압축된 레시피 색인입니다. Avatar는 정식 `/v1/avatar-1.0/*` 라우트를
사용하세요. 자세한 가이드는 [Models](/models) 아래에 있습니다.

직접 보유한 고객을 대신해 Format을 실행하는 것은 그 자체로 더 긴 레시피입니다.
[제품에 Format 임베드하기](/cookbooks/embed-a-format)에서 살펴보세요.

## 키 확인하기

```bash
curl https://api.sume.com/v1/me \
  -H "Authorization: Bearer $SUME_API_KEY"
```

## 현재 기능 목록 보기

```bash
curl https://api.sume.com/v1/catalog \
  -H "Authorization: Bearer $SUME_API_KEY"
```

## 아바타 만들기

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

## 아바타 비디오 만들기

아바타 비디오 스크립트는 4~60초 범위로 추정되어야 합니다. 기본 **`plus`**
경로를 쓰려면 `quality`를 생략하세요.

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

## 첫 프레임을 먼저 미리 보고 생성하기

<!-- api-call-example:avatar-video-preview-create -->

프리뷰 Job이 완료된 뒤에는 다음과 같습니다.

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

## 페이스 스왑 (Beta)

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

## 기존 비디오에 캡션 넣기

<!-- api-call-example:video-caption-create -->

## 트렌딩 TikTok 비디오 검색하기

<!-- api-call-example:trending-videos-search -->

## 이미지 생성하기

자세한 가이드: [Image 1.0](/models/image).

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

## 비디오 생성하기

자세한 가이드: [Video 1.0](/models/video).

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

## 음악 생성하기

자세한 가이드: [Music 1.0](/models/music). Music 1.0에는 `duration`을 보내지
마세요.

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

## 폴링하고 결과 가져오기

```bash
curl https://api.sume.com/v1/jobs/job_123/status \
  -H "Authorization: Bearer $SUME_API_KEY"

curl https://api.sume.com/v1/jobs/job_123/result \
  -H "Authorization: Bearer $SUME_API_KEY"
```

## 미디어 입력 사용하기

실행 요청 필드에 공개 HTTPS URL을 직접 쓰세요(URL 우선입니다. 일반적인
플로에서는 별도의 에셋 업로드가 필요하지 않습니다).

- Avatar 사진 입력: `input.image_url`
- Avatar Video 제품 레퍼런스: `product_image`
- Avatar Video 장면 사진 레퍼런스: `scene.image_url`
- 페이스 스왑 / 캡션 소스: `video_url`

[미디어 입력](/workflows/asset-library)에서 살펴보세요.

## 사용량 읽기

```bash
curl https://api.sume.com/v1/balance \
  -H "Authorization: Bearer $SUME_API_KEY"

curl https://api.sume.com/v1/usage \
  -H "Authorization: Bearer $SUME_API_KEY"
```