Veo 3.1 API — AI API ゲートウェイ経由で利用する(gemini-veo31)
Veo 3.1 は Google のフラッグシップとなるテキスト動画生成モデルです。映像品質が高く 1080p に対応し、映画的なカメラワークとリアルな動きを得意とします。byesu — OpenAI 互換と Anthropic ネイティブのエンドポイントを備えた AI API ゲートウェイ — を通じて呼び出せば、一つのキーで Claude、GPT-5.6、Grok、Gemini、そしてメディア系モデルまでカバーでき、サブスクリプション不要の従量課金で利用できます。プラットフォーム上のモデル名は gemini-veo31、公式アップストリームチャネル経由で提供され(リバースエンジニアリングやミラーではありません)、課金は秒単位で単価 $0.01875/秒です(実際の課金価格と公式定価の取り消し線価格はコンソールで確認できます)。
OpenAI の Sora API は 2026-09-24 に公式に提供終了となる予定で、Veo 3.1 はテキスト動画生成 API の主流な乗り換え先の一つとなっています。byesu ゲートウェイ経由なら、Sora からの移行はベース URL とモデル名の差し替えだけで済みます。
ひとことで言うと
- モデル:Google Veo 3.1 テキスト動画生成、プラットフォーム上のモデル名
gemini-veo31 - 機能:テキストから動画、画像から動画(先頭フレーム参照、最大 2 枚)、時間長は 4s / 6s / 8s から選択可、1080p 対応
- 課金:秒単位課金、単価 $0.01875/秒(例:8 秒 ≈ $0.15)、動画価格 = 単価 × 時間長
- 接続:OpenAI 互換の非同期動画エンドポイント
https://byesu.com/v1、トークンはmedia / media-genグループを使用
呼び出し方法(そのまま実行可能)
Veo 3.1 は非同期タスクとして動作し、3 ステップで進めます:タスク作成 → ステータスをポーリング → mp4 をダウンロード。
トークンは必ず media グループを使用
動画モデルを呼び出すトークンは、必ず media / media-gen グループに属している必要があります。そうでない場合は「利用可能なチャネルがありません」というエラーになります。コンソール でこのグループを指定してトークンを新規作成してください。
1) タスク作成(curl)
curl https://byesu.com/v1/videos \
-H "Authorization: Bearer sk-YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-veo31",
"prompt": "岩に打ち寄せて砕ける波、スローモーション、シネマティック、夕暮れの光",
"seconds": "8",
"size": "1280x720"
}'レスポンスにはタスクの id と status が含まれます。これを使ってポーリングします:
# ステータスをポーリング({id} を置き換えてください)
curl https://byesu.com/v1/videos/{id} \
-H "Authorization: Bearer sk-YOUR_TOKEN"
# 完了したら mp4 をダウンロード
curl https://byesu.com/v1/videos/{id}/content \
-H "Authorization: Bearer sk-YOUR_TOKEN" -o out.mp42) 完全な流れ(Python)
import requests, time
BASE = "https://byesu.com"
H = {"Authorization": "Bearer sk-YOUR_TOKEN"}
# 1. タスクを作成
task = requests.post(f"{BASE}/v1/videos", headers=H, json={
"model": "gemini-veo31",
"prompt": "岩に打ち寄せて砕ける波、スローモーション、シネマティック、夕暮れの光",
"seconds": "8", # 時間長(秒):4 / 6 / 8
"size": "1280x720", # 比率はサイズで表現;1920x1080 = 1080p
}).json()
# 2. 完了までポーリング(数十秒〜数分かかるのが通常)
while task["status"] not in ("completed", "failed"):
time.sleep(5)
task = requests.get(f"{BASE}/v1/videos/{task['id']}", headers=H).json()
# 3. mp4 をダウンロード(失敗時は自動返金、手動申請は不要)
if task["status"] == "completed":
mp4 = requests.get(f"{BASE}/v1/videos/{task['id']}/content", headers=H)
open("out.mp4", "wb").write(mp4.content)
print("out.mp4 を保存しました")3) 画像から動画(画像を先頭フレームとして使用)
一枚の静止画から動き出す動画を作るには、タスク作成リクエストを multipart/form-data に切り替え、先頭フレーム画像を input_reference ファイルフィールドに置き、残りのパラメータをフォームフィールドとして送信します:
curl https://byesu.com/v1/videos \
-H "Authorization: Bearer sk-YOUR_TOKEN" \
-F model="gemini-veo31" \
-F prompt="カメラがゆっくり前進し、風が画面の中の木の葉を揺らす" \
-F seconds="8" \
-F size="1280x720" \
-F input_reference=@first_frame.pngポーリングとダウンロードの手順は、テキストから動画の場合とまったく同じです。
主要パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
model | ✅ | 固定で gemini-veo31 を指定 |
prompt | ✅ | プロンプト。シーン + 動作 + カメラワークを記述する。例:「都市の夜景を空撮、車のライトトレイル、旋回するカメラワーク」 |
seconds | 時間長(秒)。Veo 3.1 では 4 / 6 / 8 に対応。未指定の場合はデフォルト値 | |
size | サイズで比率を表現:1280x720(16:9)、720x1280(9:16)、1920x1080(1080p) | |
input_reference | 画像から動画の先頭フレーム画像(最大 2 枚)。multipart リクエストでのみ利用可 |
ポーリングで返る status には completed / failed などの状態があります。failed の場合は自動で返金され、課金されません。
秒単位課金の計算方法
Veo 3.1 の単価は $0.01875/秒です。総額 = $0.01875 × seconds。例:6 秒 ≈ $0.1125、8 秒 ≈ $0.15。生成プレイグラウンド で時間長を選ぶと、実際の課金価格と公式定価の取り消し線価格がその場に表示されます。
なぜ byesu で Veo 3.1 を使うのか
- 公式アップストリームで品質劣化なし:呼び出しは公式チャネル経由で、リバースエンジニアリングやミラーではありません。品質と機能は公式サービスと同一で、安定して利用できます。
- 一つのゲートウェイ、一つのキー:同じ
sk-トークンで Claude、GPT-5.6、Grok、Gemini、画像モデルまでカバー。テキスト生成とメディア生成を一つの統合で扱えます。 - 透明な秒単位料金:$0.01875/秒 を明示し、コンソールでは実際の課金価格が公式定価の取り消し線価格と並んで表示されます。従量課金であいまいさがありません。
- 失敗時は自動返金:動画タスクは非同期で、生成が失敗した場合は費用が自動的に返金されます。手動での申請は不要です。
- OpenAI 互換エンドポイント:標準的な非同期動画 API なので、Python / Node / 任意の言語の HTTP からそのまま呼び出せます。
- サブスクリプション不要の従量課金:USDT、Alipay、WeChat Pay でチャージし、生成した分だけ支払います。
- 6 言語ドキュメント + オンラインプレイグラウンド:コードを書きたくない場合は、まず 生成プレイグラウンド で出力を検証できます。
関連リンク
- 📄 メディア生成の概要(画像 / 動画)
- 🎬 動画生成モデルとパラメータ
- 🔧 API で呼び出す(完全なリクエスト形式)
- 🚀 クイックスタート(3 ステップで接続)
- 🎨 オンライン生成プレイグラウンド
- 🔑 コンソールで登録 / トークン作成
よくある質問
Veo 3.1 API へのアクセスはどうやって取得しますか?
byesu のコンソールで登録し、media / media-gen グループのトークンを作成して、OpenAI 互換の非同期動画エンドポイント https://byesu.com/v1 経由で gemini-veo31 を呼び出します。byesu は AI API ゲートウェイであり、同じキーで Claude、GPT-5.6、Grok、Gemini も利用でき、サブスクリプション不要の従量課金です。Google Cloud アカウントは必要ありません。
Veo 3.1 API の料金はいくらですか?
byesu では Veo 3.1(gemini-veo31)は秒単位課金で、単価は $0.01875/秒です。動画の総額 = 単価 × 時間長で、例えば 6 秒なら約 $0.1125、8 秒なら約 $0.15 です。コンソールには実際の課金価格が公式定価(取り消し線表示)と並んで表示され、失敗した動画タスクは自動で返金されます。
Veo 3.1 は画像から動画(image-to-video)に対応していますか?
対応しています。タスク作成時に multipart/form-data 形式を使い、先頭フレーム画像を input_reference ファイルフィールドに置く(最大 2 枚)と、モデルはその画像から動き出す動画を生成します。テキストから動画の場合は通常の JSON リクエストを使い、画像を省略するだけで構いません。
Veo 3.1 を呼び出すと「利用可能なチャネルがありません」と返る場合はどうすればいいですか?
ほとんどの場合、トークンのグループ指定ミスが原因です。動画モデルには media / media-gen グループのトークンが必要です。コンソールでこのグループを指定してトークンを新規作成し、再試行してください。あわせて、モデル名が正確に gemini-veo31 と綴られているかも確認してください。
Veo 3.1 の動画生成にはどれくらい時間がかかりますか?
動画生成は画像生成より遅く、数十秒から数分かかるのが通常です。非同期タスクなので、タスク作成後は GET /v1/videos/{id} でステータスをポーリングし、completed になったら /content エンドポイントから mp4 をダウンロードします。同じタスクを繰り返し作成しないでください。
Sora API の提供終了に伴い、Veo 3.1 は良い乗り換え先になりますか?
なります。OpenAI の Sora API は 2026-09-24 に公式に提供終了となる予定で、Veo 3.1 は現在主流のテキスト動画生成モデルの中でも有力な代替の一つです。映像品質が高く、1080p と画像から動画に対応しています。byesu は公式アップストリーム経由のアクセスを単価 $0.01875/秒で提供し、失敗時は自動返金されるため、Sora からの移行はベース URL とモデル名を差し替えるだけで完了します。
