Paramedrau
Mae pob model yn cadw ei enwau paramedrau brodorol, ac mae pob tudalen model yn eu rhestru. Yn ogystal â hynny, mae'r API yn derbyn enwau canonaidd ar gyfer y paramedrau sy'n golygu'r un peth ar bob model, felly mae cod a ysgrifennwyd ar gyfer un model yn gweithio ar y model nesaf gyda llai o newidiadau.
Enwau canonaidd
| Enw canonaidd | Ystyr | Enwau brodorol nodweddiadol |
|---|---|---|
image |
Y ddelwedd fewnbwn neu'r ddelwedd ffrâm gyntaf | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Delwedd y ffrâm olaf | end_image_url, last_frame_url, tail_image_url |
images |
Rhestr o ddelweddau cyfeirio | image_urls, reference_image_urls |
video |
Y fideo mewnbwn | video_url |
videos |
Rhestr o fideos cyfeirio | video_urls |
audio |
Y sain fewnbwn | audio_url |
audios |
Rhestr o glipiau sain cyfeirio | audio_urls |
mask |
Delwedd fasg | mask_url |
num_outputs |
Faint o ganlyniadau i'w cynhyrchu | num_images |
generate_audio |
Cynhyrchu sain gyda'r fideo | generate_audio_switch, enable_audio |
I ba faes brodorol y mae enw canonaidd yn mapio ar bob model cyfredol:
| Enw canonaidd | Maes brodorol (modelau sy’n ei ddefnyddio) |
|---|---|
audio |
audio_url (modelau: 126) |
audios |
audio_urls (modelau: 7), reference_audio_urls (modelau: 1) |
end_image |
end_image_url (modelau: 76), last_frame_url (modelau: 12), tail_image_url (modelau: 1) |
generate_audio |
generate_audio_switch (modelau: 16), audio (modelau: 3) |
image |
image_url (modelau: 529), start_image_url (modelau: 20), first_frame_url (modelau: 12), first_image_url (modelau: 7), source_image_url (modelau: 2) |
images |
image_urls (modelau: 148), reference_image_urls (modelau: 31) |
mask |
mask_url (modelau: 46) |
num_outputs |
num_images (modelau: 337) |
video |
video_url (modelau: 197) |
videos |
video_urls (modelau: 13), reference_video_urls (modelau: 1) |
Rheolau:
- Anfonwch naill ai'r enw canonaidd neu'r enw brodorol. Os anfonwch y ddau â gwerthoedd gwahanol, bydd yr alwad yn methu gyda
422 invalid_inputar yr enw canonaidd. - Caiff paramedr nad yw'n enw brodorol nac yn enw canonaidd y model ei wrthod gyda
422 invalid_input("Unknown parameter"), ynghyd â'r enw dilys agosaf fel awgrym. Nid yw teipos byth yn pasio'n dawel. - Mae pob tudalen model yn dangos y ddau enw ochr yn ochr.
Gorfodi mathau
Caiff gwerthoedd eu trosi i'r math y mae'r model yn ei ddisgwyl, felly mae'r rhain i gyd yn gweithio:
| Rydych yn anfon | Mae'r model yn disgwyl | Yn dod yn |
|---|---|---|
5, "5", "5s" |
duration fel llinyn megis "5" |
"5" |
"8" |
cyfanrif | 8 |
"1080P", "4K" |
resolution megis "1080p", "4k" |
yr sillafiad union a ganiateir |
"true", "false", 1, 0 |
gwerth Booleaidd | true, false |
"https://…/a.jpg" |
rhestr o URLs | ["https://…/a.jpg"] |
42 |
llinyn | "42" |
Caiff gwerthoedd a ganiateir eu paru'n union yn gyntaf, yna gan anwybyddu llythrennau mawr a bach, ac yna fel rhifau (5 yn paru â gwerthoedd yn arddull "5", "5s" a
"5 s").
Rhagosodiadau
Mae paramedrau rydych yn eu hepgor yn defnyddio rhagosodiad y model, a restrir yn nhabl paramedrau'r model. Cyfrifir y pris
gan ddefnyddio'r un rhagosodiadau (er enghraifft, mae model fideo y mae generate_audio yn rhagosod i true yn cael ei brisio gyda
sain oni bai eich bod yn anfon "generate_audio": false).
Paramedrau ffeiliau
Mae paramedrau delwedd, fideo a sain yn derbyn URL cyhoeddus, URI data: hyd at 10 MB, neu file_url uwchlwythiad.
Gweler Ffeiliau.