# Tham số

Mỗi mô hình giữ nguyên tên tham số gốc và mỗi trang mô hình đều liệt kê chúng. Ngoài ra, API chấp nhận
**tên chuẩn** cho các tham số có cùng ý nghĩa trên mọi mô hình, vì vậy mã được viết cho một mô hình vẫn hoạt động
với mô hình tiếp theo mà cần ít thay đổi hơn.

## Tên chuẩn

| Tên chuẩn | Ý nghĩa | Tên gốc thường dùng |
|---|---|---|
| `image` | Hình ảnh đầu vào hoặc khung hình đầu tiên | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Hình ảnh khung hình cuối | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Danh sách hình ảnh tham chiếu | `image_urls`, `reference_image_urls` |
| `video` | Video đầu vào | `video_url` |
| `videos` | Danh sách video tham chiếu | `video_urls` |
| `audio` | Âm thanh đầu vào | `audio_url` |
| `audios` | Danh sách đoạn âm thanh tham chiếu | `audio_urls` |
| `mask` | Hình ảnh mặt nạ | `mask_url` |
| `num_outputs` | Số lượng kết quả cần tạo sinh | `num_images` |
| `generate_audio` | Tạo âm thanh cùng với video | `generate_audio_switch`, `enable_audio` |

Tên trường gốc mà mỗi tên chuẩn ánh xạ tới trên từng mô hình hiện tại:

| Tên chuẩn | Trường gốc (các mô hình sử dụng trường này) |
|---|---|
| `audio` | `audio_url` (mô hình: 126) |
| `audios` | `audio_urls` (mô hình: 7), `reference_audio_urls` (mô hình: 1) |
| `end_image` | `end_image_url` (mô hình: 76), `last_frame_url` (mô hình: 12), `tail_image_url` (mô hình: 1) |
| `generate_audio` | `generate_audio_switch` (mô hình: 16), `audio` (mô hình: 3) |
| `image` | `image_url` (mô hình: 529), `start_image_url` (mô hình: 20), `first_frame_url` (mô hình: 12), `first_image_url` (mô hình: 7), `source_image_url` (mô hình: 2) |
| `images` | `image_urls` (mô hình: 148), `reference_image_urls` (mô hình: 31) |
| `mask` | `mask_url` (mô hình: 46) |
| `num_outputs` | `num_images` (mô hình: 337) |
| `video` | `video_url` (mô hình: 197) |
| `videos` | `video_urls` (mô hình: 13), `reference_video_urls` (mô hình: 1) |

Quy tắc:

- Gửi tên chuẩn hoặc tên gốc. Nếu gửi cả hai với các giá trị khác nhau, lệnh gọi sẽ thất bại với
  `422 invalid_input` trên tên chuẩn.
- Tham số không phải là tên gốc hoặc tên chuẩn của mô hình sẽ bị từ chối với `422 invalid_input`
  ("Unknown parameter"), kèm theo tên hợp lệ gần nhất làm gợi ý. Lỗi chính tả không bao giờ được âm thầm chấp nhận.
- Mỗi trang mô hình hiển thị cả hai tên cạnh nhau.

## Ép kiểu

Các giá trị được chuyển đổi sang kiểu mà mô hình yêu cầu, vì vậy tất cả các trường hợp sau đều hoạt động:

| Bạn gửi | Mô hình yêu cầu | Trở thành |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` dưới dạng chuỗi như `"5"` | `"5"` |
| `"8"` | một số nguyên | `8` |
| `"1080P"`, `"4K"` | `resolution` như `"1080p"`, `"4k"` | cách viết chính xác được cho phép |
| `"true"`, `"false"`, `1`, `0` | một giá trị boolean | `true`, `false` |
| `"https://…/a.jpg"` | một danh sách URL | `["https://…/a.jpg"]` |
| `42` | một chuỗi | `"42"` |

Các giá trị được so khớp chính xác trước, sau đó không phân biệt chữ hoa chữ thường, rồi dưới dạng số (`5` khớp với các giá trị kiểu `"5"`, `"5s"` và
`"5 s"`).

## Giá trị mặc định

Các tham số bạn bỏ qua sẽ sử dụng giá trị mặc định của mô hình, được liệt kê trong bảng tham số của mô hình. Giá được
tính theo cùng các giá trị mặc định đó (ví dụ: một mô hình video có `generate_audio` mặc định là `true` sẽ được tính giá
kèm âm thanh trừ khi bạn gửi `"generate_audio": false`).

## Tham số tệp

Các tham số hình ảnh, video và âm thanh nhận URL công khai, URI `data:` tối đa 10 MB hoặc `file_url` của một tệp đã tải lên.
Xem [Tệp](https://doitong.com/developers/docs/files).