Gemini Omni 1.1 Flash

テキスト、先頭フレーム、先頭・末尾フレーム、または最大 10 枚の参照画像と 3 本の参照動画から、720p・1080p・4K で 3～10 秒の音声付き動画を生成します。

• 非同期：作成リクエストはタスク ID を返し、タスクが成功すると動画を取得できます。
• 1 つのモデル ID で 4 種類の入力に対応します：テキストのみ、先頭フレーム 1 枚、images の先頭・末尾フレーム、または最大 10 枚の reference_images と任意で最大 3 本の reference_videos。フレームと参照は同時に使えません。
• 長さは 3～10 秒、画面比率は 16:9 または 9:16 です。duration は秒単位の整数です。
• すべての動画に音声が付きます。音声をオフにするスイッチはなく、参照音声も受け付けません。
• 解像度とリクエストした秒数に応じて課金されます。失敗したタスクは無料です。

このモデルをテスト画面で開きます。BeatAPI の API キーを入力するとタスクを作成できます。実際に呼び出され、ご自身の残高から課金されます。

エンドポイントと認証

POST https://api.beatapi.io/v1/videos/tasks

ボディは JSON で送信し、Content-Type: application/json を指定します。Idempotency-Key は任意です。論理的に 1 件のリクエストごとに一意の値（255 文字以内）を送り、まったく同じボディを再試行するときだけ再利用してください。24 時間以内に同じキーと同じボディで再試行すると、最初のレスポンスが Idempotent-Replayed: true 付きで再度返されます。同じキーで異なるボディを送ると 409 idempotency_conflict が返ります。2xx 以外のレスポンスは保存されないため、400 や 402 の後の再試行は改めて実行されます。

リクエストの流れ

入力モード

リクエストパラメーター

ゲートウェイはタスク作成前に、次の組み合わせも確認します。

• images と参照メディアのフィールドは同時に使用できません。
• images はフレームです。1 枚なら先頭フレーム、2 枚なら順に先頭フレームと末尾フレームです。
• reference_videos を送るときは、reference_images に画像が 1 枚以上必要です。
• 音声のオン・オフを切り替える設定はありません。参照音声には対応していません。

入力メディアの上限

ゲートウェイはタスク作成前にすべての入力を読み取り、次の上限を超えるものは、その入力を示す 400 bad_request で拒否します。課金はされません。

• ゲートウェイはタスクを作成する前に、各リンク先ファイルのサイズを確認します。上限を超えるファイルは、どのファイルかを示す 400 で拒否され、料金はかかりません。例：images[0] is 25.0 MB; this model takes images up to 20 MB.
• リンク先のホストが 4xx エラーを返した場合や、ファイルが空の場合も同じように拒否されます：<field>[<n>] could not be downloaded: <reason>.
• タスク作成後にモデルがリンクを利用できなかった場合、タスクは失敗し（通常は bad_request）、全額返金されます。
• ローカルのファイルは、POST /v1/files でアップロードし、返された data.url を渡してください。

このモデルが受け付けないフィールド

次のフィールドを送ると、無視されるのではなく、課金前に拒否されます。

• reference_audios、generate_audio、seed、quality、sound、task_type、output_format、watermark など他の動画モデルのフィールド → field "generate_audio" is not supported by model gemini-omni-1.1-flash（送ったフィールド名が入ります）。音声は毎回生成されるため、切り替えるものはありません。
• 動画エンドポイントがまったく認識しないフィールド → unknown field: <name>。

リクエスト例

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-omni-1.1-flash",
  "prompt": "A dramatic product reveal of a glass water bottle, slow orbiting camera, soft studio reflections",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

テキストから動画

テキストだけから 5 秒・720p の横長クリップを生成します。

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-omni-1.1-flash",
  "prompt": "A dramatic product reveal of a glass water bottle, slow orbiting camera, soft studio reflections",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

先頭フレーム

1 枚の画像から始まる 5 秒・720p のクリップです。

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-omni-1.1-flash",
  "prompt": "The singer turns toward the camera and smiles, hair moving in the breeze, warm spotlights",
  "images": [
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 5,
  "resolution": "720p"
}'

先頭・末尾フレーム

1 枚目の画像から 2 枚目の画像へ移る 8 秒・1080p のクリップです。

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-omni-1.1-flash",
  "prompt": "The camera pulls away from the singer and glides across the stage to the bottle on a table",
  "images": [
    "https://cdn.beatapi.io/samples/neon-singer.png",
    "https://cdn.beatapi.io/samples/smart-bottle.png"
  ],
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}'

参照画像と参照動画 1 本

参照画像 2 枚と参照動画 1 本から、8 秒・720p の縦長クリップを生成します。

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-omni-1.1-flash",
  "prompt": "The singer from the first reference image lifts the bottle from the second toward the camera, following the camera move of the reference video",
  "reference_images": [
    "https://cdn.beatapi.io/samples/neon-singer.png",
    "https://cdn.beatapi.io/samples/smart-bottle.png"
  ],
  "reference_videos": [
    "https://your-cdn.example.com/clips/source.mp4"
  ],
  "duration": 8,
  "aspect_ratio": "9:16",
  "resolution": "720p"
}'

レスポンス

タスクの作成（201）

タスクオブジェクトです。タスクが成功するまで output は null です。「実行中」と記載されたフィールドは、タスクの完了後に表示されなくなります。

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "gemini-omni-1.1-flash",
    "capability_version": 1,
    "media_type": "video",
    "model": "gemini-omni-1.1-flash",
    "status": "queued",
    "stage": "queued",
    "created_at": 1791993600,
    "updated_at": 1791993600,
    "completed_at": null,
    "poll_after_seconds": 8,
    "output": null,
    "usage": {
      "credits_reserved": 0.3,
      "credits_settled": 0,
      "credits_refunded": 0,
      "credits_charged": 0.3,
      "billable_duration_seconds": 5
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

完了したタスク

GET /v1/tasks/{task_id} は HTTP 200 と status: "succeeded" を返し、結果は data.output に入ります。

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "gemini-omni-1.1-flash",
    "capability_version": 1,
    "media_type": "video",
    "model": "gemini-omni-1.1-flash",
    "status": "succeeded",
    "stage": "succeeded",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": {
      "media": [
        {
          "type": "video",
          "url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.mp4",
          "mime_type": "video/mp4"
        }
      ],
      "r2_url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.mp4"
    },
    "usage": {
      "credits_reserved": 0.3,
      "credits_settled": 0.3,
      "credits_refunded": 0,
      "credits_charged": 0.3,
      "billable_duration_seconds": 5
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

出力フィールド

失敗したタスク

失敗したタスクも、GET /v1/tasks/{task_id} では HTTP 200 になります。失敗はボディに示されます。仮確保された金額は全額戻されるため、課金されません。

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "gemini-omni-1.1-flash",
    "capability_version": 1,
    "media_type": "video",
    "model": "gemini-omni-1.1-flash",
    "status": "failed",
    "stage": "failed",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": null,
    "usage": {
      "credits_reserved": 0.3,
      "credits_settled": 0,
      "credits_refunded": 0.3,
      "credits_charged": 0,
      "billable_duration_seconds": 5
    },
    "retryable": true,
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": "processing_failed",
    "error_message": "The task failed during processing on our side. Retry; a failed task is refunded."
  }
}

完全なコード例

タスクを作成し、サーバーが示すポーリング間隔で完了を待ち、結果の URL を出力します。環境変数に BEATAPI_API_KEY を設定し、requests をインストールしてください。

import os
import time
import uuid
import requests
API = "https://api.beatapi.io"
HEADERS = {"Authorization": f"Bearer {os.environ['BEATAPI_API_KEY']}"}
def create_task(body: dict) -> dict:
    # One Idempotency-Key per logical request: a retry with the same key cannot create a second task.
    headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
    for attempt in range(3):
        response = requests.post(f"{API}/v1/videos/tasks", headers=headers, json=body, timeout=60)
        if response.status_code in (429, 503) and attempt < 2:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        break
    try:
        payload = response.json()
    except ValueError:  # an edge error page is not JSON
        response.raise_for_status()
        raise
    if not response.ok:
        error = payload["error"]
        raise RuntimeError(f"{response.status_code} {error['code']}: {error['message']} (request_id={error.get('request_id')})")
    return payload["data"]
def wait_for_task(task_id: str, timeout_seconds: int = 1800) -> dict:
    deadline = time.monotonic() + timeout_seconds
    while time.monotonic() < deadline:
        response = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
        if response.status_code == 429 or response.status_code >= 500:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        response.raise_for_status()
        task = response.json()["data"]
        if task["status"] in ("succeeded", "failed"):
            return task
        time.sleep(task.get("poll_after_seconds", 5))
    raise TimeoutError(f"task {task_id} is still running; keep polling later")
task = create_task({
  "model": "gemini-omni-1.1-flash",
  "prompt": "A dramatic product reveal of a glass water bottle, slow orbiting camera, soft studio reflections",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
})
print("created", task["id"])
task = wait_for_task(task["id"])
if task["status"] == "failed":
    raise SystemExit(f"{task['error_code']}: {task['error_message']}")
for item in task["output"]["media"]:
    print(item["url"])

課金

• 料金は、解像度とリクエストした秒数（duration、省略時は 5）に応じて決まります。1 秒あたりの料金は 720p より 1080p、1080p より 4K が高くなります。入力の種類、aspect_ratio、フレームや参照素材の数は料金に影響しません。
• 下の表は 8 秒のクリップの料金です。他の長さは、解像度ごとの同じ単価で 1 秒単位で計算されます。
• 料金はタスク作成時に確保されます。data.usage.billable_duration_seconds に計算の基になった秒数が表示されます。
• 失敗したタスク（送信後にモデレーションで拒否されたものを含む）は全額返金されます。

現在の定価です。料金ページと同じ金額です。割引を個別に契約しているアカウントでは、より低い金額になります。実際に課金された金額は、タスクの data.usage で確認できます。

よくあるエラー

HTTP エラー早見表

タスクが作られる前のエラーは、2xx 以外のレスポンスで返されます。課金はされません。error.code または error.retryable で処理を分岐してください。message には問題の内容が示されます。全一覧と再試行のルールはエラーにあります。

{
  "error": {
    "code": "bad_request",
    "message": "\"prompt\" is required",
    "retryable": false,
    "request_id": "req_5f0c2a9e4b7d4e31"
  }
}