Lompat ke konten
Bahasa Indonesia
Dapatkan kunci API
Panduan API

Parameter

Lihat sebagai Markdown Diperbarui

Setiap model mempertahankan nama parameter bawaannya, dan setiap halaman model mencantumkannya. Selain itu, API menerima nama kanonis untuk parameter yang memiliki arti sama pada setiap model, sehingga kode yang ditulis untuk satu model dapat digunakan pada model berikutnya dengan lebih sedikit perubahan.

Nama kanonis

Nama kanonis Arti Nama bawaan yang umum
image Gambar input atau bingkai pertama image_url, start_image_url, first_frame_url, first_image_url, source_image_url
end_image Gambar bingkai terakhir end_image_url, last_frame_url, tail_image_url
images Daftar gambar referensi image_urls, reference_image_urls
video Video input video_url
videos Daftar video referensi video_urls
audio Audio input audio_url
audios Daftar klip audio referensi audio_urls
mask Gambar mask mask_url
num_outputs Jumlah hasil yang akan dibuat num_images
generate_audio Membuat suara bersama video generate_audio_switch, enable_audio

Field bawaan yang dipetakan oleh setiap nama kanonis pada setiap model saat ini:

Nama kanonis Field native (model yang menggunakannya)
audio audio_url (model: 126)
audios audio_urls (model: 7), reference_audio_urls (model: 1)
end_image end_image_url (model: 76), last_frame_url (model: 12), tail_image_url (model: 1)
generate_audio generate_audio_switch (model: 16), audio (model: 3)
image image_url (model: 529), start_image_url (model: 20), first_frame_url (model: 12), first_image_url (model: 7), source_image_url (model: 2)
images image_urls (model: 148), reference_image_urls (model: 31)
mask mask_url (model: 46)
num_outputs num_images (model: 337)
video video_url (model: 197)
videos video_urls (model: 13), reference_video_urls (model: 1)

Aturan:

  • Kirim nama kanonis atau nama bawaannya. Jika Anda mengirim keduanya dengan nilai berbeda, panggilan gagal dengan 422 invalid_input pada nama kanonis.
  • Parameter yang bukan nama bawaan maupun nama kanonis model akan ditolak dengan 422 invalid_input ("Parameter tidak dikenal"), beserta nama valid terdekat sebagai saran. Kesalahan ketik tidak pernah lolos tanpa pemberitahuan.
  • Setiap halaman model menampilkan kedua nama tersebut berdampingan.

Koersi tipe

Nilai dikonversi ke tipe yang diharapkan model, sehingga semua contoh berikut berfungsi:

Yang Anda kirim Yang diharapkan model Menjadi
5, "5", "5s" duration sebagai string seperti "5" "5"
"8" bilangan bulat 8
"1080P", "4K" resolution seperti "1080p", "4k" ejaan yang diizinkan secara tepat
"true", "false", 1, 0 boolean true, false
"https://…/a.jpg" daftar URL ["https://…/a.jpg"]
42 string "42"

Nilai yang diizinkan dicocokkan secara tepat terlebih dahulu, lalu tanpa membedakan huruf besar-kecil, kemudian sebagai angka (5 cocok dengan nilai bergaya "5", "5s", dan "5 s").

Bawaan

Parameter yang tidak Anda sertakan akan menggunakan nilai bawaan model, yang tercantum dalam tabel parameter model. Harga dihitung menggunakan nilai bawaan yang sama (misalnya, model video yang generate_audio-nya secara bawaan adalah true akan dihargai dengan suara kecuali Anda mengirim "generate_audio": false).

Parameter file

Parameter gambar, video, dan audio menerima URL publik, URI data: hingga 10 MB, atau file_url dari file yang diunggah. Lihat File.