Skip to main content
POST
cURL
このエンドポイントを使用すると、テキスト指示で既存の MP4 を編集できます。出力は、新規生成リクエストよりも、元のクリップのタイミングや構図により近い状態を保ちます。

リクエストを送信する前に

  • 到達可能な video.url を指定してください
  • 元のクリップは短くしてください。xAI 自身のガイダンスでは、編集は約 8.7 秒までに制限されています
  • 1 つの明確な変更を説明する、焦点を絞った指示を使用してください
  • 編集では生成と同じポーリングフローを使用するため、返された request_id を保存してください

編集フロー

1

編集リクエストを送信

元動画の URL、編集プロンプト、そして model: grok-imagine-video を送信します。
2

最終結果をポーリング

ジョブが完了するまで xAI 動画結果を取得 を呼び出します。
3

編集済みアセットを保存

完成した出力をダウンロードするか、返された URL を自分のストレージパイプラインに移動します。

CometAPI で変わること

xAI は動画編集を、生成と同じ非同期ライフサイクルとして文書化しており、違いはオプションの元画像ではなく元動画を使う点だけです。CometAPI はこの動作と同じポーリングエンドポイントを維持しているため、編集ワークフローも start -> poll -> download のままです。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json
prompt
string
必須

Edit instruction describing the change you want.

:

"Add snow to the scene."

video
object
必須

Source video to edit. xAI documents an input limit of about 8.7 seconds.

model
string
デフォルト:grok-imagine-video

xAI video model id.

:

"grok-imagine-video"

output
object

Optional output delivery configuration.

user
string

Optional end-user identifier.

レスポンス

200 - application/json

Request accepted.

request_id
string
必須

Deferred request id used for polling.