メインコンテンツへスキップ
POST
/
grok
/
v1
/
videos
/
edits
Create an xAI video edit job
curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Add snow to the scene.",
  "video": {
    "url": "https://example.com/source.mp4"
  }
}
'
{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}
このエンドポイントを使用すると、既存の MP4 をテキスト指示で編集できます。出力は、新規生成リクエストよりも元のクリップのタイミングや構図に近い状態を維持します。

リクエスト送信前に

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

編集フロー

1

編集リクエストを送信

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

最終結果をポーリング

ジョブが完了するまで 動画生成結果の取得 を呼び出します。
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.