メインコンテンツへスキップ
POST
/
v1
/
videos
/
{video_id}
/
remix
Create a Sora remix job
curl --request POST \
  --url https://api.cometapi.com/v1/videos/{video_id}/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Shift the color palette to teal, sand, and rust, with a warm backlight."
}
'
{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "progress": 123,
  "created_at": 123,
  "size": "<string>",
  "seconds": "<string>",
  "remixed_from_video_id": "<string>"
}
このエンドポイントを使用すると、最初から作り直すことなく、完了済みの Sora 動画のバリエーションを作成できます。リミックスは、変更内容を限定的かつ明確にすると最も効果的です。

良いリミックス用プロンプト

  • シーン全体を書き換えるのではなく、1つの明確な変更を依頼する
  • ライティング、色調、カメラの動き、雰囲気への言及は具体的にする
  • 進行中のジョブではなく、完了済みの元動画を使う

リミックスの流れ

1

まずベースのレンダリングを完了する

Create Video で元動画を作成し、完了するまで待ちます。
2

リミックスリクエストを送信する

完了済みの video_id を、1つの焦点を絞った変更を説明するプロンプトとともに渡します。
3

リミックスをポーリングしてダウンロードする

リミックスのレスポンスは新しい非同期ジョブとして扱い、Retrieve Video でポーリングし、その後 Retrieve Video Content でダウンロードします。

OpenAI との対応関係

これは OpenAI がドキュメントで示しているリミックスのパターンに従っています。CometAPI では同じ考え方を維持しつつ、ワークフロー全体を通して CometAPI のベース URL と認証モデルを使用できます。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

パスパラメータ

video_id
string
必須

Completed source video id.

ボディ

application/json
prompt
string
必須

Describe the change you want to make to the existing video.

:

"Shift the color palette to teal, sand, and rust, with a warm backlight."

レスポンス

200 - application/json

Remix job accepted.

id
string
必須
object
string
必須
model
string
必須
status
string
必須
progress
integer
必須
created_at
integer
必須
size
string
必須
seconds
string
必須
remixed_from_video_id
string
必須