Skip to main content
POST
cURL
Bir kaynak videoyu metin Prompt’u ile düzenlemek için 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.
  • model değerini aleph2 olarak ayarlayın ve en fazla 30 saniyelik bir video için videoUri sağlayın.
  • İsteğe bağlı: Düzenlemeyi açıklamak için 1 ila 1.000 karakter içeren promptText ekleyin. 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çin keyframes içinde bir ila beş nesne sağlayın. Her nesne bir görsel uri ve tam olarak bir konum içerir: Keyframe zaman damgası, düzenleme penceresinin içinde olmalıdır. 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ülen id 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

Authorization
string
header
gerekli

Your CometAPI API key.

Gövde

application/json

Aleph 2 video-editing request.

model
enum<string>
gerekli

Model ID for this request.

Mevcut seçenekler:
aleph2
videoUri
gerekli

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.

Required string length: 13 - 2048
Pattern: ^https://
promptText
string

Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.

Required string length: 1 - 1000
keyframes
object[] | null

One 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.

Maximum array length: 5

Guidance image positioned using seconds.

targetAspectRatio
enum<string>

Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.

Mevcut seçenekler:
16:9,
4:3,
3:2,
1:1,
2:3,
3:4,
9:16,
21:9
ratio
string
kullanımdan kaldırıldı

Deprecated aspect-ratio field. Use targetAspectRatio instead.

seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Gerekli aralık: 0 <= x <= 4294967295
outputFormat
enum<string>

Output 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.

Mevcut seçenekler:
mp4,
prores,
png_sequence,
sdr_rec709_10bit
proresProfile
enum<string>

ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.

Mevcut seçenekler:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Yanıt

The task was created. Save its id for task retrieval.

id
string
gerekli

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Son değiştirilme tarihi 18 Eylül 2026