メインコンテンツへスキップ
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
認証

​
Authorization
string
必須
すべてのAPIエンドポイントでBearer Tokenによる認証が必要ですAPI Keyの取得：API Key管理ページにアクセスしてAPI Keyを取得してください使用時はリクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名利用可能なモデル：
  • veo3.1-fast-official - Veo 3.1 公式高速版
  • veo3.1-quality-official - Veo 3.1 公式高品質版
​
prompt
string
必須
正のテキストプロンプトシーン、アクション、スタイルなどを詳細に記述すると、より良い生成結果が得られます。英語プロンプトの使用を推奨します。例："a golden retriever running on the beach, sunset, cinematic"
​
negative_prompt
string
不要なコンテンツを除外するためのネガティブプロンプト例："blurry, low quality, watermark, text"
​
duration
integer
デフォルト:"8"
動画の長さ（秒）推奨値：4 / 6 / 8デフォルト：8⚠️ 注意： 純粋な数値（例：8）を入力してください。引用符を付けるとエラーが発生します
​
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比選択可能な値：
  • 16:9 - 横向き
  • 9:16 - 縦向き
デフォルト：16:9
​
resolution
string
デフォルト:"720p"
動画解像度選択可能な値：
  • 720p - 標準解像度
  • 1080p - 高解像度
  • 4K - 超高解像度
デフォルト：720p
​
first_frame_image
string
先頭フレーム画像URL、画像から動画生成に使用
  • 画像URLは公開アクセス可能で、ホットリンク保護がないものが必要です
  • 一時ダウンロードリンクではなく、オブジェクトストレージURLの使用を推奨します
​
last_frame_image
string
末尾フレーム画像URL、画像から動画生成に使用first_frame_image と組み合わせて、先頭・末尾フレームの制御を実現します
​
seed
integer
生成結果を再現するためのランダムシード値の範囲：0 - 4294967295
​
sample_count
integer
デフォルト:"1"
生成サンプル数 1-4、現在は 1 の使用を推奨デフォルト：1
​
generate_audio
boolean
デフォルト:"false"
音声トラックを生成するかどうか
​
person_generation
string
デフォルト:"allow_adult"
人物生成ポリシー選択可能な値：
  • allow_adult - 成人の人物/顔のみ生成を許可
  • disallow - 人物や顔の生成を許可しない
デフォルト：allow_adult
​
resize_mode
string
デフォルト:"pad"
画像リサイズ戦略（画像から動画生成時に有効）選択可能な値：
  • pad - パディングモード
  • crop - クロップモード
デフォルト：pad
​
enhance_prompt
boolean
デフォルト:"true"
上流プロンプト強化を有効にするかどうかデフォルト値：true
  • このパラメータは true のみ設定可能です。false に設定するとリクエストエラーが発生します
  • このパラメータが不要な場合は、送信しないでください

​
テキストから動画 vs 画像から動画

システムは画像パラメータの有無で自動的にモードを判定します：画像なしはテキストから動画、画像ありは画像から動画。
パラメータテキストから動画画像から動画
prompt✅ 必須✅ 必須
first_frame_image❌ 不要✅ 少なくとも1つ必要
last_frame_image❌ 不要✅ オプション（末尾フレーム）
negative_prompt✅ オプション✅ オプション
duration✅ オプション✅ オプション
aspect_ratio✅ オプション✅ オプション
resolution✅ オプション✅ オプション
seed✅ オプション✅ オプション
generate_audio✅ オプション✅ オプション
person_generation✅ オプション✅ オプション
resize_mode❌ 該当なし✅ オプション
enhance_prompt✅ オプション✅ オプション

​
レスポンス

​
code
integer
レスポンスステータスコード、成功時は 200
​
data
array
レスポンスデータ配列

​
使用シナリオ

​
シナリオ 1：テキストから動画（基本）

{
  "model": "veo3.1-fast-official",
  "prompt": "a golden retriever running on the beach, sunset, cinematic"
}

​
シナリオ 2：テキストから動画（全パラメータ）

{
  "model": "veo3.1-quality-official",
  "prompt": "a cinematic close-up of a ragdoll cat slowly walking through a sunlit living room",
  "negative_prompt": "blurry, low quality, watermark, text",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "seed": 12345,
  "generate_audio": true,
  "person_generation": "disallow",
  "enhance_prompt": true
}

​
シナリオ 3：画像から動画（先頭フレーム1枚）

{
  "model": "veo3.1-fast-official",
  "prompt": "the cat slowly walks forward and looks around",
  "first_frame_image": "https://example.com/cat.png",
  "duration": 8,
  "resolution": "720p"
}

​
シナリオ 4：画像から動画（先頭フレーム + 末尾フレーム）

{
  "model": "veo3.1-quality-official",
  "prompt": "smooth cinematic transition from the first frame to the last frame",
  "first_frame_image": "https://example.com/frame-start.png",
  "last_frame_image": "https://example.com/frame-end.png",
  "duration": 8,
  "resolution": "1080p"
}

​
シナリオ 5：音声付き動画の生成

{
  "model": "veo3.1-quality-official",
  "prompt": "a busy coffee shop with people chatting and barista making latte art",
  "duration": 8,
  "generate_audio": true,
  "aspect_ratio": "16:9"
}
タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。