İçeriğe geç
Türkçe
API anahtarı al
API kılavuzu

Parametreler

Markdown olarak görüntüle Güncellendi

Her model kendi yerel parametre adlarını kullanır ve her model sayfasında bunlar listelenir. Bunun yanı sıra API, her modelde aynı anlama gelen parametreler için standart adları kabul eder; böylece bir model için yazılan kod, bir sonraki model için daha az değişiklikle çalışır.

Standart adlar

Standart ad Anlamı Tipik yerel adlar
image Girdi veya ilk kare görüntüsü image_url, start_image_url, first_frame_url, first_image_url, source_image_url
end_image Son kare görüntüsü end_image_url, last_frame_url, tail_image_url
images Referans görüntülerinin listesi image_urls, reference_image_urls
video Girdi videosu video_url
videos Referans videolarının listesi video_urls
audio Girdi sesi audio_url
audios Referans ses kliplerinin listesi audio_urls
mask Maske görüntüsü mask_url
num_outputs Oluşturulacak sonuç sayısı num_images
generate_audio Videoyla birlikte ses oluştur generate_audio_switch, enable_audio

Her güncel modelde bir standart adın hangi yerel alana eşlendiği:

Kanonik ad Yerel alan (kullanan modeller)
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)

Kurallar:

  • Standart adı veya yerel adı gönderin. Farklı değerlerle ikisini birden gönderirseniz çağrı, standart ad için 422 invalid_input hatasıyla başarısız olur.
  • Modelin yerel veya standart adı olmayan bir parametre 422 invalid_input ("Unknown parameter") ile reddedilir ve en yakın geçerli ad öneri olarak sunulur. Yazım hataları hiçbir zaman sessizce kabul edilmez.
  • Her model sayfası her iki adı yan yana gösterir.

Tür dönüşümü

Değerler, modelin beklediği türe dönüştürülür; bu nedenle aşağıdakilerin tümü çalışır:

Gönderdiğiniz Modelin beklediği Dönüşür
5, "5", "5s" duration, "5" gibi bir dize "5"
"8" bir tam sayı 8
"1080P", "4K" "1080p", "4k" gibi bir resolution izin verilen tam yazım
"true", "false", 1, 0 bir boolean true, false
"https://…/a.jpg" URL listesi ["https://…/a.jpg"]
42 bir dize "42"

İzin verilen değerler önce tam olarak, ardından büyük/küçük harf göz ardı edilerek, sonra da sayı olarak eşleştirilir (5, "5", "5s" ve "5 s" biçimindeki değerlerle eşleşir).

Varsayılanlar

Belirtmediğiniz parametreler, modelin parametre tablosunda listelenen varsayılan değeri kullanır. Fiyat aynı varsayılanlar kullanılarak hesaplanır (örneğin, generate_audio varsayılanı true olan bir video modeli, "generate_audio": false göndermediğiniz sürece ses dahil fiyatlandırılır).

Dosya parametreleri

Görüntü, video ve ses parametreleri herkese açık bir URL, en fazla 10 MB boyutunda bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar sayfasına bakın.