Przejdź do treści
Polski
Uzyskaj klucz API
Przewodnik po API

Parametry

Wyświetl jako Markdown Zaktualizowano

Każdy model zachowuje własne natywne nazwy parametrów, a na każdej stronie modelu znajduje się ich lista. Ponadto API akceptuje kanoniczne nazwy parametrów, które oznaczają to samo w każdym modelu, dzięki czemu kod napisany dla jednego modelu działa w kolejnym przy mniejszej liczbie zmian.

Nazwy kanoniczne

Nazwa kanoniczna Znaczenie Typowe nazwy natywne
image Obraz wejściowy lub obraz pierwszej klatki image_url, start_image_url, first_frame_url, first_image_url, source_image_url
end_image Obraz ostatniej klatki end_image_url, last_frame_url, tail_image_url
images Lista obrazów referencyjnych image_urls, reference_image_urls
video Wideo wejściowe video_url
videos Lista referencyjnych plików wideo video_urls
audio Dźwięk wejściowy audio_url
audios Lista referencyjnych klipów audio audio_urls
mask Obraz maski mask_url
num_outputs Liczba wyników do wygenerowania num_images
generate_audio Generowanie dźwięku wraz z wideo generate_audio_switch, enable_audio

Natywne pole, na które mapuje nazwa kanoniczna w każdym obecnym modelu:

Nazwa kanoniczna Pole natywne (modele, które go używają)
audio audio_url (modeli: 126)
audios audio_urls (modeli: 7), reference_audio_urls (modeli: 1)
end_image end_image_url (modeli: 76), last_frame_url (modeli: 12), tail_image_url (modeli: 1)
generate_audio generate_audio_switch (modeli: 16), audio (modeli: 3)
image image_url (modeli: 529), start_image_url (modeli: 20), first_frame_url (modeli: 12), first_image_url (modeli: 7), source_image_url (modeli: 2)
images image_urls (modeli: 148), reference_image_urls (modeli: 31)
mask mask_url (modeli: 46)
num_outputs num_images (modeli: 337)
video video_url (modeli: 197)
videos video_urls (modeli: 13), reference_video_urls (modeli: 1)

Zasady:

  • Wyślij nazwę kanoniczną albo natywną. Jeśli wyślesz obie z różnymi wartościami, wywołanie zakończy się błędem 422 invalid_input dla nazwy kanonicznej.
  • Parametr, który nie jest nazwą natywną ani kanoniczną danego modelu, zostanie odrzucony z błędem 422 invalid_input ("Unknown parameter"), wraz z sugestią najbliższej prawidłowej nazwy. Literówki nigdy nie są ignorowane.
  • Na stronie każdego modelu obie nazwy są pokazane obok siebie.

Konwersja typów

Wartości są konwertowane do typu oczekiwanego przez model, dlatego wszystkie poniższe przykłady działają:

Wysyłasz Model oczekuje Wynik
5, "5", "5s" duration jako ciąg znaków, np. "5" "5"
"8" liczba całkowita 8
"1080P", "4K" resolution, np. "1080p", "4k" dokładna dozwolona pisownia
"true", "false", 1, 0 wartość logiczna true, false
"https://…/a.jpg" lista adresów URL ["https://…/a.jpg"]
42 ciąg znaków "42"

Dozwolone wartości są najpierw dopasowywane dokładnie, następnie bez uwzględniania wielkości liter, a na końcu jako liczby (5 pasuje do wartości "5", "5s" i "5 s").

Wartości domyślne

Pominięte parametry używają wartości domyślnych modelu, które są podane w tabeli parametrów modelu. Cena jest obliczana z użyciem tych samych wartości domyślnych (na przykład model wideo, którego generate_audio ma domyślną wartość true, jest wyceniany z dźwiękiem, chyba że wyślesz "generate_audio": false).

Parametry plików

Parametry obrazów, wideo i audio przyjmują publiczny adres URL, identyfikator URI data: o rozmiarze do 10 MB lub wartość file_url przesłanego pliku. Zobacz Pliki.