Lumaktaw sa nilalaman
Filipino
Kumuha ng API key
Gabay sa API

Mga Parameter

Tingnan bilang Markdown Na-update

Pinapanatili ng bawat modelo ang mga native na pangalan ng parameter nito, at inililista ang mga ito sa bawat pahina ng modelo. Bukod dito, tumatanggap ang API ng mga canonical na pangalan para sa mga parameter na pareho ang kahulugan sa bawat modelo, kaya gumagana ang code na isinulat para sa isang modelo sa susunod na modelo nang mas kaunti ang kailangang baguhin.

Mga canonical na pangalan

Canonical na pangalan Kahulugan Karaniwang native na pangalan
image Ang input o larawan ng unang frame image_url, start_image_url, first_frame_url, first_image_url, source_image_url
end_image Ang larawan ng huling frame end_image_url, last_frame_url, tail_image_url
images Isang listahan ng mga reference na larawan image_urls, reference_image_urls
video Ang input na video video_url
videos Isang listahan ng mga reference na video video_urls
audio Ang input na audio audio_url
audios Isang listahan ng mga reference na audio clip audio_urls
mask Isang mask na larawan mask_url
num_outputs Kung ilang resulta ang bubuuin num_images
generate_audio Bumuo ng tunog kasama ng video generate_audio_switch, enable_audio

Aling native na field ang tinutukoy ng isang canonical na pangalan sa bawat kasalukuyang modelo:

Canonical na pangalan Native na field (mga modelong gumagamit nito)
audio audio_url (mga modelo: 126)
audios audio_urls (mga modelo: 7), reference_audio_urls (mga modelo: 1)
end_image end_image_url (mga modelo: 76), last_frame_url (mga modelo: 12), tail_image_url (mga modelo: 1)
generate_audio generate_audio_switch (mga modelo: 16), audio (mga modelo: 3)
image image_url (mga modelo: 529), start_image_url (mga modelo: 20), first_frame_url (mga modelo: 12), first_image_url (mga modelo: 7), source_image_url (mga modelo: 2)
images image_urls (mga modelo: 148), reference_image_urls (mga modelo: 31)
mask mask_url (mga modelo: 46)
num_outputs num_images (mga modelo: 337)
video video_url (mga modelo: 197)
videos video_urls (mga modelo: 13), reference_video_urls (mga modelo: 1)

Mga panuntunan:

  • Ipadala ang canonical na pangalan o ang native na pangalan. Kung pareho mong ipapadala ang mga ito na magkaiba ang halaga, mabibigo ang tawag sa 422 invalid_input para sa canonical na pangalan.
  • Tinatanggihan ang parameter na hindi native o canonical na pangalan ng modelo sa 422 invalid_input ("Unknown parameter"), kasama ang pinakamalapit na wastong pangalan bilang mungkahi. Hindi kailanman tahimik na tinatanggap ang mga typo.
  • Ipinapakita ng bawat pahina ng modelo ang parehong pangalan nang magkatabi.

Pagko-convert ng type

Kino-convert ang mga value sa type na inaasahan ng modelo, kaya gumagana ang lahat ng ito:

Ipinapadala mo Inaasahan ng modelo Nagiging
5, "5", "5s" duration bilang string gaya ng "5" "5"
"8" isang integer 8
"1080P", "4K" resolution gaya ng "1080p", "4k" ang eksaktong pinapahintulutang baybay
"true", "false", 1, 0 isang boolean true, false
"https://…/a.jpg" isang listahan ng mga URL ["https://…/a.jpg"]
42 isang string "42"

Eksaktong itinutugma muna ang mga pinapahintulutang value, pagkatapos ay hindi isinasaalang-alang ang laki ng titik, at pagkatapos ay bilang (5 ay tumutugma sa mga value na gaya ng "5", "5s" at "5 s").

Mga Default

Ginagamit ng mga parameter na hindi mo isinama ang default ng modelo, na nakalista sa talahanayan ng mga parameter ng modelo. Kinukuwenta ang presyo ayon sa parehong mga default (halimbawa, ang isang modelo ng video na ang default ng generate_audio ay true ay sinisingil nang may tunog maliban kung ipapadala mo ang "generate_audio": false).

Mga parameter ng file

Tumatanggap ang mga parameter ng larawan, video at audio ng pampublikong URL, isang data: URI na hanggang 10 MB, o ang file_url ng isang upload. Tingnan ang Mga file.