Documentation Index Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
cURL
Python
JavaScript
Go
Java
PHP
Ruby
Swift
C#
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" } ] }
すべてのAPIエンドポイントでBearer Tokenによる認証が必要です API Keyの取得： API Key管理ページ にアクセスしてAPI Keyを取得してください使用時はリクエストヘッダーに追加： Authorization: Bearer YOUR_API_KEY
リクエストパラメータ 動画生成モデル名 利用可能なモデル：
veo3.1-fast-official - Veo 3.1 公式高速版veo3.1-quality-official - Veo 3.1 公式高品質版 正のテキストプロンプト シーン、アクション、スタイルなどを詳細に記述すると、より良い生成結果が得られます。英語プロンプトの使用を推奨します。 例："a golden retriever running on the beach, sunset, cinematic"
不要なコンテンツを除外するためのネガティブプロンプト 例："blurry, low quality, watermark, text"
動画の長さ（秒） 推奨値：4 / 6 / 8 デフォルト：8 ⚠️ 注意： 純粋な数値（例：8）を入力してください。引用符を付けるとエラーが発生します
動画のアスペクト比 選択可能な値： デフォルト：16:9 動画解像度 選択可能な値：
720p - 標準解像度1080p - 高解像度4K - 超高解像度 デフォルト：720p 先頭フレーム画像URL、画像から動画生成に使用
画像URLは公開アクセス可能で、ホットリンク保護がないものが必要です
一時ダウンロードリンクではなく、オブジェクトストレージURLの使用を推奨します
末尾フレーム画像URL、画像から動画生成に使用 first_frame_image と組み合わせて、先頭・末尾フレームの制御を実現します
生成結果を再現するためのランダムシード 値の範囲：0 - 4294967295
生成サンプル数 1-4、現在は 1 の使用を推奨 デフォルト：1
person_generation
string
デフォルト: "allow_adult"
人物生成ポリシー 選択可能な値：
allow_adult - 成人の人物/顔のみ生成を許可disallow - 人物や顔の生成を許可しない デフォルト：allow_adult 画像リサイズ戦略（画像から動画生成時に有効） 選択可能な値：
pad - パディングモードcrop - クロップモード デフォルト：pad 上流プロンプト強化を有効にするかどうか デフォルト値：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✅ オプション ✅ オプション
レスポンス レスポンスデータ配列 タスクステータス、送信時の初期値は submitted
タスクの一意識別子、タスクステータスと結果のクエリに使用
使用シナリオ シナリオ 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 が返されます。タスクステータスの取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。