Skip to main content
POST
cURL
aleph2 を使用して、テキストプロンプトでソース動画を編集します。リクエストでは タスク id が返されます。完了した出力を取得するには、タスクの詳細を取得してください。

リクエストを準備する

  • CometAPI APIキーで認証します。
  • modelaleph2 に設定し、最大30秒の動画には videoUri を指定します。
  • 任意: 編集内容を説明する promptText を含めます。長さは1~1,000 文字です。キーフレームを使用する場合は省略することもできます。
  • 例のメディアURLをアクセス可能なHTTPS URLに置き換えてください。メディアフィールドでは エンコード後のサイズが最大5 MBのBase64データURIも使用できます。

時間指定のガイダンス画像を追加する

特定の時点をガイドするには、keyframes に1~5個のオブジェクトを指定します。 各オブジェクトには画像の uri と、次の位置指定のいずれか1つだけが含まれます。 キーフレームのタイムスタンプは、その編集ウィンドウ内に収まる必要があります。range を使用する場合は、 すべてのキーフレームに設定してください。それ以外の場合は、すべてのキーフレームで range を省略してください。 ガイダンス画像が不要な場合は keyframes を省略してください。空の配列または null は省略として扱われます。

フレームの形状と形式を選択する

targetAspectRatio を使用して、16:94:33:21:1 2:3, 3:4, 9:16、または 21:9 への拡張をリクエストできます。入力動画とガイダンス画像は 生成前にこの形状にレターボックス化されます。非推奨の ratio フィールドは 任意です。アスペクト比を制御するには targetAspectRatio を使用してください。 outputFormatprores の場合、proresProfile4224444 422 Proxy, 422 LT, 422 HQ、または 4444 XQ に設定できます。デフォルトのプロファイルは 4444 です。 4444 および 4444 XQ のアルファチャネルは不透明です。proresProfile は 他の出力形式では省略してください。 明示的にサンプリングシードを指定するには、1 から 4294967295 を使用します。seed は ランダムなシードには省略してください。0 は省略として扱われます。

結果を取得する

返された id を保存し、 Runwayタスクを取得 を使用してタスクのステータスを取得します。 statusSUCCEEDED の場合、結果のURLを output から読み取ります。タスクが 失敗した場合は、存在すれば failurefailureCode を確認してください。

承認

Authorization
string
header
必須

Your CometAPI API key.

ボディ

application/json

Aleph 2 video-editing request.

model
enum<string>
必須

Model ID for this request.

利用可能なオプション:
aleph2
videoUri
必須

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.

利用可能なオプション:
16:9,
4:3,
3:2,
1:1,
2:3,
3:4,
9:16,
21:9
ratio
string
非推奨

Deprecated aspect-ratio field. Use targetAspectRatio instead.

seed
integer

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

必須範囲: 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.

利用可能なオプション:
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.

利用可能なオプション:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ
contentModeration
object

Content moderation settings. Omit to use the standard settings.

レスポンス

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

id
string
必須

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.

最終更新日 2026年9月18日