# 매개변수

각 모델은 고유한 매개변수 이름을 사용하며, 각 모델 페이지에 해당 이름이 나와 있습니다. 이와 함께 API는 모든 모델에서 동일한 의미를 갖는 매개변수에 대해 **표준 이름**도 허용하므로, 한 모델용으로 작성한 코드를 다음 모델에서도 더 적은 변경으로 사용할 수 있습니다.

## 표준 이름

| 표준 이름 | 의미 | 일반적인 고유 이름 |
|---|---|---|
| `image` | 입력 이미지 또는 첫 프레임 이미지 | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | 마지막 프레임 이미지 | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | 참조 이미지 목록 | `image_urls`, `reference_image_urls` |
| `video` | 입력 동영상 | `video_url` |
| `videos` | 참조 동영상 목록 | `video_urls` |
| `audio` | 입력 오디오 | `audio_url` |
| `audios` | 참조 오디오 클립 목록 | `audio_urls` |
| `mask` | 마스크 이미지 | `mask_url` |
| `num_outputs` | 생성할 결과 수 | `num_images` |
| `generate_audio` | 동영상과 함께 사운드 생성 | `generate_audio_switch`, `enable_audio` |

현재 각 모델에서 표준 이름이 매핑되는 고유 필드:

| 표준 이름 | 네이티브 필드(사용하는 모델) |
|---|---|
| `audio` | `audio_url` (모델: 126개) |
| `audios` | `audio_urls` (모델: 7개), `reference_audio_urls` (모델: 1개) |
| `end_image` | `end_image_url` (모델: 76개), `last_frame_url` (모델: 12개), `tail_image_url` (모델: 1개) |
| `generate_audio` | `generate_audio_switch` (모델: 16개), `audio` (모델: 3개) |
| `image` | `image_url` (모델: 529개), `start_image_url` (모델: 20개), `first_frame_url` (모델: 12개), `first_image_url` (모델: 7개), `source_image_url` (모델: 2개) |
| `images` | `image_urls` (모델: 148개), `reference_image_urls` (모델: 31개) |
| `mask` | `mask_url` (모델: 46개) |
| `num_outputs` | `num_images` (모델: 337개) |
| `video` | `video_url` (모델: 197개) |
| `videos` | `video_urls` (모델: 13개), `reference_video_urls` (모델: 1개) |

규칙:

- 표준 이름 또는 고유 이름 중 하나를 전송합니다. 서로 다른 값으로 둘 다 전송하면 표준 이름에서 `422 invalid_input` 오류와 함께 요청이 실패합니다.
- 모델의 고유 이름도 표준 이름도 아닌 매개변수는 가장 가까운 유효한 이름을 제안하며 `422 invalid_input`("Unknown parameter")으로 거부됩니다. 오타가 조용히 통과되는 일은 없습니다.
- 각 모델 페이지에는 두 이름이 나란히 표시됩니다.

## 형 변환

값은 모델이 기대하는 형으로 변환되므로 다음 예시는 모두 작동합니다.

| 전송하는 값 | 모델이 기대하는 값 | 변환 결과 |
|---|---|---|
| `5`, `"5"`, `"5s"` | `"5"`와 같은 문자열로서의 `duration` | `"5"` |
| `"8"` | 정수 | `8` |
| `"1080P"`, `"4K"` | `"1080p"`, `"4k"`와 같은 `resolution` | 정확히 허용되는 표기 |
| `"true"`, `"false"`, `1`, `0` | 불리언 | `true`, `false` |
| `"https://…/a.jpg"` | URL 목록 | `["https://…/a.jpg"]` |
| `42` | 문자열 | `"42"` |

허용되는 값은 먼저 정확히 일치하는지 확인하고, 그다음 대소문자를 무시한 상태로 확인하며, 마지막으로 숫자로 확인합니다(`5`는 `"5"`, `"5s"`, `"5 s"` 형식의 값과 일치합니다).

## 기본값

생략한 매개변수에는 모델의 기본값이 사용되며, 이 값은 모델의 매개변수 표에 나와 있습니다. 가격도 동일한 기본값으로 계산됩니다(예를 들어 `generate_audio`의 기본값이 `true`인 동영상 모델은 `"generate_audio": false`를 전송하지 않는 한 사운드가 포함된 가격으로 계산됩니다).

## 파일 매개변수

이미지, 동영상 및 오디오 매개변수에는 공개 URL, 최대 10MB의 `data:` URI 또는 업로드한 파일의 `file_url`을 사용할 수 있습니다. [파일](https://doitong.com/developers/docs/files)을 참조하세요.