Léim chuig an ábhar
Treoir API

Paraiméadair

Féach mar Markdown Nuashonraithe

Coinníonn gach samhail a hainmneacha paraiméadar dúchasacha, agus liostaíonn gach leathanach samhla iad. Ina theannta sin, glacann an API le hainmneacha canónacha do na paraiméadair a chiallaíonn an rud céanna i ngach samhail, ionas go n-oibríonn cód a scríobhadh do shamhail amháin leis an gcéad cheann eile agus níos lú athruithe de dhíth.

Ainmneacha canónacha

Ainm canónach Brí Ainmneacha dúchasacha tipiciúla
image An íomhá ionchuir nó íomhá an chéad fhráma image_url, start_image_url, first_frame_url, first_image_url, source_image_url
end_image Íomhá an fhráma dheireanaigh end_image_url, last_frame_url, tail_image_url
images Liosta íomhánna tagartha image_urls, reference_image_urls
video An físeán ionchuir video_url
videos Liosta físeán tagartha video_urls
audio An fhuaim ionchuir audio_url
audios Liosta gearrthóg fuaime tagartha audio_urls
mask Íomhá masc mask_url
num_outputs Cé mhéad toradh atá le giniúint num_images
generate_audio Fuaim a ghiniúint leis an bhfíseán generate_audio_switch, enable_audio

Cén réimse dúchasach a mapáiltear ainm canónach chuige i ngach samhail reatha:

Ainm canónach Réimse dúchasach (samhlacha a úsáideann é)
audio audio_url (samhlacha: 126)
audios audio_urls (samhlacha: 7), reference_audio_urls (samhlacha: 1)
end_image end_image_url (samhlacha: 76), last_frame_url (samhlacha: 12), tail_image_url (samhlacha: 1)
generate_audio generate_audio_switch (samhlacha: 16), audio (samhlacha: 3)
image image_url (samhlacha: 529), start_image_url (samhlacha: 20), first_frame_url (samhlacha: 12), first_image_url (samhlacha: 7), source_image_url (samhlacha: 2)
images image_urls (samhlacha: 148), reference_image_urls (samhlacha: 31)
mask mask_url (samhlacha: 46)
num_outputs num_images (samhlacha: 337)
video video_url (samhlacha: 197)
videos video_urls (samhlacha: 13), reference_video_urls (samhlacha: 1)

Rialacha:

  • Seol an t-ainm canónach nó an t-ainm dúchasach. Má sheolann tú an dá cheann le luachanna éagsúla, teipeann ar an nglao le 422 invalid_input ar an ainm canónach.
  • Diúltaítear do pharaiméadar nach ainm dúchasach ná ainm canónach de chuid na samhla é le 422 invalid_input ("Unknown parameter"), agus taispeántar an t-ainm bailí is gaire mar mholadh. Ní ghlactar le botúin litrithe go ciúin riamh.
  • Taispeánann gach leathanach samhla an dá ainm taobh le taobh.

Comhéigean cineáil

Tiontaítear luachanna chuig an gcineál a bhfuil súil ag an tsamhail leis, mar sin oibríonn siad seo go léir:

Seolann tú Tá an tsamhail ag súil le Éiríonn sé
5, "5", "5s" duration mar theaghrán amhail "5" "5"
"8" slánuimhir 8
"1080P", "4K" resolution amhail "1080p", "4k" an litriú cruinn ceadaithe
"true", "false", 1, 0 booleán true, false
"https://…/a.jpg" liosta URLanna ["https://…/a.jpg"]
42 teaghrán "42"

Déantar na luachanna ceadaithe a mheaitseáil go cruinn ar dtús, ansin gan aird ar chás, agus ansin mar uimhreacha (5 meaitseálann "5", "5s" agus luachanna den stíl "5 s").

Réamhshocruithe

Úsáideann paraiméadair a fhágann tú ar lár réamhshocrú na samhla, atá liostaithe i dtábla paraiméadar na samhla. Ríomhtar an praghas leis na réamhshocruithe céanna (mar shampla, gearrtar praghas ar shamhail físeáin a bhfuil generate_audio réamhshocraithe aici mar true le fuaim, mura seolann tú "generate_audio": false).

Paraiméadair chomhaid

Glacann paraiméadair íomhá, físeáin agus fuaime le URL poiblí, URI data: suas le 10 MB, nó file_url uaslódála. Féach Comhaid.