Bir Runway video-to-video görevi oluşturma
Bir metin Prompt’u, zamanlamalı yönlendirme görselleri ve isteğe bağlı hedef en-boy oranı kullanarak CometAPI aracılığıyla Runway Aleph 2 ile bir videoyu düzenleyin.
aleph2 kullanın. İstek bir
görev id döndürür; tamamlanmış çıktıyı almak için görev ayrıntılarını getirin.
İsteği hazırlama
- CometAPI API anahtarınızla kimlik doğrulaması yapın.
modeldeğerinialeph2olarak ayarlayın ve en fazla 30 saniyelik bir video içinvideoUrisağlayın.- İsteğe bağlı: Düzenlemeyi açıklamak için 1 ila 1.000 karakter içeren
promptTextekleyin. Keyframe kullanırken bunu atlayabilirsiniz. - Örnek medya URL’sini erişilebilir bir HTTPS URL’siyle değiştirin. Medya alanları ayrıca kodlanmış boyutu en fazla 5 MB olan Base64 veri URI’lerini kabul eder.
Zamanlamalı yönlendirme görselleri ekleme
Belirli anlara yön vermek içinkeyframes içinde bir ila beş nesne sağlayın.
Her nesne bir görsel uri ve tam olarak bir konum içerir:
range kullanıyorsanız,
bunu her keyframe’de ayarlayın. Aksi takdirde, range öğesini her keyframe’den çıkarın.
Yönlendirme görsellerine ihtiyacınız olmadığında keyframes öğesini atlayın. Boş bir dizi veya
null atlama olarak değerlendirilir.
Kare şeklini ve biçimini seçme
targetAspectRatio, 16:9, 4:3, 3:2, 1:1 boyutlarına genişletme istemek için
2:3, 3:4, 9:16, ya da 21:9 için kullanın. Girdi videosu ve yönlendirme görselleri
oluşturma öncesinde bu şekle göre letterbox uygulanır. Kullanımdan kaldırılan ratio alanı
isteğe bağlıdır; en-boy oranı denetimi için targetAspectRatio kullanın.
outputFormat değeri prores ise proresProfile değerini 422, 4444 olarak ayarlayabilirsiniz
422 Proxy, 422 LT, 422 HQ, ya da 4444 XQ. Varsayılan profil 4444 değeridir.
4444 ve 4444 XQ içindeki alfa kanalı opaktır. proresProfile öğesini
diğer çıktı biçimleri için atlayın.
Açık bir örnekleme seed’i için 1 ile 4294967295 arasını kullanın. seed öğesini
rastgele bir seed için atlayın; 0 atlama olarak değerlendirilir.
Sonucu alma
Döndürülenid değerini kaydedin ve
Bir Runway görevi alma görev durumunu almak için kullanın.
status değeri SUCCEEDED olduğunda, sonuç URL’lerini output içinden okuyun. Görev
başarısız olursa, mevcut olduğunda failure ve failureCode öğelerini inceleyin.Yetkilendirmeler
Your CometAPI API key.
Gövde
Aleph 2 video-editing request.
Model ID for this request.
aleph2 Input video to edit, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.
13 - 2048^https://Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.
1 - 1000One to five timed guidance images. Each image uses exactly one of seconds or at. Omit when no guidance images are needed; an empty array or null is treated as omission.
5Guidance image positioned using seconds.
- Option 1
- Option 2
Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.
16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9 Deprecated aspect-ratio field. Use targetAspectRatio instead.
Sampling seed. Omit for a random seed; 0 is treated as omission.
0 <= x <= 4294967295Output format: mp4 for H.264 MP4, prores for ProRes MOV, png_sequence for a ZIP of PNG frames, or sdr_rec709_10bit for 10-bit Rec.709 HEVC MP4. Omit for mp4.
mp4, prores, png_sequence, sdr_rec709_10bit ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.
422, 4444, 422 Proxy, 422 LT, 422 HQ, 4444 XQ Content moderation settings. Omit to use the standard settings.
Yanıt
The task was created. Save its id for task retrieval.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Task cost metadata, when returned.