テキスト、画像、または動画から Omni 動画を作成

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

このベータエンドポイントを使用して、テキストから動画、画像から動画、または動画から動画のタスクを作成します。API はタスク ID をすぐに返すため、返された id を保存し、タスクが最終ステータスに達するまでポーリングしてください。入力モードに一致するリクエストのコンテンツタイプを選択します。テキストから動画および画像から動画の制御値は multipart/form-data フィールドとして送信します。参照動画の編集は application/json ボディとして送信します。

入力モードを選択する

目的	コンテンツタイプ	必須フィールド	任意フィールド
テキストから動画	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
画像から動画	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
動画から動画	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

テキストから動画および画像から動画の例では model=omni-fast を使用します。動画から動画の例では model=omni-fast-v2v を使用します。モデル ID が API キーに表示されることを確認するには、利用可能なモデルを一覧表示を使用してください。

参照画像をアニメーション化する

画像から動画では model=omni-fast を使用し、multipart の input_reference フィールドに PNG ファイルを 1 つアップロードします。このフィールドはテキストから動画では任意ですが、参照画像で生成動画を制御する場合は必須です。 prompt では追加する動きに焦点を当て、結果で保持すべき色、形状、被写体、または構図を明示的に指定します。コードサンプルのセレクターには、作業ディレクトリから reference.png をアップロードしてタスクを作成する Shell、Python、JavaScript の例が含まれています。このリクエスト形式は、アップロードする PNG 1 つを対象としています。URL 入力、その他の画像形式、複数の参照画像、またはファイルサイズ制限は定義されていません。

参照動画を編集する

動画から動画では、ローカル MP4 ファイルを base64 としてエンコードし、エンコードされたバイト列の先頭に data:video/mp4;base64, を付加します。完全なデータ URL を video フィールドで送信します。要求する変更を prompt に記述します。また、結果で保持すべき被写体、オブジェクト、構図、または動きも指定します。コードサンプルのセレクターには、作業ディレクトリから reference.mp4 を読み取る Shell、Python、JavaScript の例が含まれています。このリクエスト形式は、インライン MP4 データ URL を対象としています。URL 入力、その他の動画コンテナ形式、またはファイルサイズ制限は定義されていません。

継続時間、アスペクト比、解像度を設定する

Omni は、生成の安定性が入力と選択したルートによって変わる可能性があるため、ベータとして扱われています。最初のリクエストは小さく抑え、特定のレンダリング後の再生時間やフレームサイズを前提とする前に、完了した動画を確認してください。

設定	サポートされる値	デフォルト	境界時の動作
`seconds`	まずは `4`	ルートに依存	出力の再生時間は異なる可能性があるため、これは要求された再生時間として扱い、完了した MP4 を確認してください。
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` は縦向きの出力をレンダリングできます。`1:1` は、横向きでレンダリングされる場合でも受け付けられることがあります。
`resolution`	まずは `720p` を使用してください。`1080p` も受け付けられることがあります。	`720p`	現在の本番出力は `720p` に正規化される場合があり、`1080p` を要求した場合でも同様です。

リクエスト	確認された完了フレーム
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

このエンドポイントはベータ版であるため、aspect_ratio と resolution は生成時の設定希望として扱い、最終的なピクセルを前提とする前にダウンロードした MP4 を確認してください。

タスクフロー

タスクを作成する

選択した入力モード用のコンテンツタイプでリクエストを送信し、返された id を保存します。

タスクをポーリングする

次の Omni 動画を取得するエンドポイントを、status が completed または failed になるまで呼び出します。

結果をダウンロードする

タスクが completed になったら、次の Omni 動画コンテンツを取得するエンドポイントを呼び出して MP4 ファイルをダウンロードします。

承認

Authorization

string

header

必須

Bearer authentication. Use your CometAPI API key.

ボディ

model

string

必須

Omni model ID for this endpoint. Use omni-fast for text-to-video and image-to-video.

例:

"omni-fast"

prompt

string

必須

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

例:

"Ocean waves rolling onto a sandy beach at golden hour"

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

例:

"4"

aspect_ratio

enum<string>

デフォルト:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

利用可能なオプション:

16:9,

9:16,

1:1

例:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

例:

"720p"

レスポンス

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

string

必須

Task ID. Use this value with retrieve and content endpoints.

例:

"task_example"

object

string

必須

Object type. Video tasks return video.

例:

"video"

model

string

必須

Model ID used for the task.

例:

"omni-fast"

status

enum<string>

必須

Task lifecycle status. Poll until the value is completed, failed, or error.

利用可能なオプション:

queued,

in_progress,

completed,

failed,

error

例:

"queued"

progress

integer

必須

Task progress as a coarse percentage.

必須範囲: 0 <= x <= 100

例:

0

created_at

integer

必須

Task creation time as a Unix timestamp in seconds.

例:

1779938152

task_id

string

Compatibility alias for id when present.

例:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

例:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

例:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

最終更新日 2026年8月4日

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

コンテンツモデレーション

APIキー

テキスト、画像、または動画から Omni 動画を作成

入力モードを選択する

参照画像をアニメーション化する

参照動画を編集する

継続時間、アスペクト比、解像度を設定する

タスクフロー

承認

ボディ

レスポンス

​入力モードを選択する

​参照画像をアニメーション化する

​参照動画を編集する

​継続時間、アスペクト比、解像度を設定する

​タスクフロー

承認

ボディ

レスポンス

入力モードを選択する

参照画像をアニメーション化する

参照動画を編集する

継続時間、アスペクト比、解像度を設定する

タスクフロー