Bỏ qua đến nội dung
Tiếng Việt
Lấy khóa API
Hướng dẫn API

Tham số

Xem dưới dạng Markdown Đã cập nhật

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.