メインコンテンツへスキップ
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",
    "prompt": "イルカが青い海で跳び回る",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'

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

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",
    "prompt": "イルカが青い海で跳び回る",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'

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

​
認証

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

​
リクエストボディ

​
model
string
デフォルト:"veo3.1-fast"
必須
動画生成モデル名利用可能なモデル：
  • veo3.1-fast - 高速生成モデル、クイックプレビューと反復処理に適しています
  • veo3.1-quality - 高品質生成モデル、最終制作に適しています
  • veo3.1-lite - 軽量生成モデル、低コストの大量生成に適しています
Example: "veo3.1-fast"
​
prompt
string
必須
動画生成のテキスト説明
​
duration
integer
動画の長さ（秒）固定値：8（VEO3 は 8 秒の長さのみサポート）
​
aspect_ratio
string
動画のアスペクト比サポートされている形式：
  • 16:9 (横向き)
  • 9:16 (縦向き)
​
generation_type
string
動画生成タイプサポートされているタイプ：
  • frame - フレームから動画へ（FLモード）
  • reference - 参照画像から動画へ
未指定の場合、画像数に基づいて自動判定：2枚はフレームから動画、3枚は参照画像から動画注意：veo3.1-quality モデルは reference モードをサポートしていません
veo3.1-lite モデルはこのパラメータをサポートしていません、渡さないでください
​
image_urls
array<url>
動画生成に使用する参考画像URLの配列公開アクセス可能な画像URL（http:// または https://）をサポート例：["https://example.com/image.jpg"]制限：
  • 最大3枚
  • フレームから動画モードの場合：1枚目が開始フレーム、2枚目が終了フレーム
  • 最大ファイルサイズ：10MB
  • サポート形式：.jpeg、.jpg、.png、.webp
veo3.1-lite モデルはこのパラメータをサポートしていません、渡さないでください
​
resolution
string
動画解像度サポートされる値：
  • 720p（デフォルト）
  • 1080p
  • 4k
​
enable_gif
boolean
GIF出力形式を有効にする。デフォルト：false注意：GIFと1080p、4k解像度は同時に使用できません
​
official_fallback
boolean
デフォルト:"false"
公式チャネルをフォールバックとして使用するかどうか
  • false：使用しない（デフォルト）
  • true：公式チャネルを使用する
veo3.1-lite モデルはこのパラメータをサポートしていません、渡さないでください

​
レスポンス

​
code
integer
レスポンスステータスコード
​
data
array
レスポンスデータ配列