メインコンテンツへスキップ
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": "doubao-seedance-2.0",
    "prompt": "子猫がカメラに向かってあくびをする",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "子猫がカメラに向かってあくびをする",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

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

​
認証

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

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名サポートされるモデル：
  • doubao-seedance-2.0 - スタンダード版、テキストから動画、画像から動画、最初/最後のフレーム動画、参照動画、参照音声、音声付き動画をサポート
  • doubao-seedance-2.0-fast - 高速版、スタンダード版と同じ機能で、生成速度がより高速
​
prompt
string
動画コンテンツの説明テキストから動画の場合は必須、画像から動画/動画参照生成の場合はオプション主題、アクション、カメラワーク、スタイルを明確に記述すると、より良い生成結果が得られます例："子猫がカメラに向かってあくびをする"
​
duration
integer
デフォルト:"5"
動画の長さ（秒）サポート範囲：5 ~ 15 秒デフォルト：5
​
size
string
デフォルト:"16:9"
動画のアスペクト比オプション：
  • 16:9 - 横画面
  • 9:16 - 縦画面
  • 1:1 - 正方形
  • 4:3 - 従来の比率
  • 3:4 - 縦向き従来の比率
  • 21:9 - ウルトラワイド
  • adaptive - 自適応（入力画像/動画に応じて自動的にマッチング）
デフォルト：16:9
​
resolution
string
デフォルト:"480p"
動画の解像度オプション：
  • 480p - 標準画質
  • 720p - 高画質
デフォルト：480p
​
seed
integer
ランダムシード、生成コンテンツのランダム性を制御するために使用
  • 同じリクエストで異なる seed 値を受け取ると、異なる結果が生成されます
  • 同じリクエストで同じ seed 値を受け取ると、類似の結果が生成されますが、完全に一致することは保証されません
​
camera_fixed
boolean
デフォルト:"false"
カメラを固定するかどうかtrue に設定すると、カメラ位置が固定されますデフォルト：false
​
generate_audio
boolean
デフォルト:"false"
音声を生成するかどうか（音声付き動画）true に設定すると、動画にAI生成の音声が含まれますデフォルト：false
​
return_last_frame
boolean
デフォルト:"false"
最後のフレーム画像を返すかどうかtrue に設定すると、タスク結果に動画の最後のフレームの画像URLが追加で返されます。連続動画生成に使用できますデフォルト：false
​
tools
array<object>
ツールリスト、ウェブ検索などの拡張機能に使用例：[{"type": "web_search"}]
​
image_urls
array<string>
画像URL配列、画像から動画に使用例：["https://example.com/cat.jpg"]
  • image_urls と image_with_roles は同時に使用できません
  • 最大9枚の参照画像
​
image_with_roles
array
ロール付き画像配列、最初のフレーム/最後のフレームの指定をサポート例：
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
  • image_urls と image_with_roles は同時に使用できません
  • 最初/最後のフレーム画像を使用する場合、video_urls と audio_urls は使用できません
​
video_urls
array<string>
参照動画URL配列公開アクセス可能な動画URLが必要です例：["https://example.com/reference.mp4"]
  • 最初/最後のフレーム画像（image_with_roles）を使用する場合、参照動画は使用できません
  • 最大3つの参照動画、合計時間 ≤ 15s
  • 参照動画の解像度は 480P ~ 720P の範囲である必要があります
​
audio_urls
array<string>
参照音声URL配列公開アクセス可能な音声URLが必要です例：["https://example.com/speech.wav"]
  • 最初/最後のフレーム画像（image_with_roles）を使用する場合、参照音声は使用できません
  • 最大3つの参照音声、合計時間 ≤ 15s
  • 参照音声は参照画像または参照動画と一緒に使用する必要があります

​
レスポンス

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

​
ユースケース

​
ケース 1：テキストから動画

{
  "model": "doubao-seedance-2.0",
  "prompt": "子猫がカメラに向かってあくびをする",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}

​
ケース 2：画像から動画（最初のフレーム）

{
  "model": "doubao-seedance-2.0",
  "prompt": "子猫が立ち上がってカメラに向かって歩く",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}

​
ケース 3：最初/最後のフレーム動画

{
  "model": "doubao-seedance-2.0",
  "prompt": "昼から夜への移り変わり",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

​
ケース 4：動画参照から動画生成

{
  "model": "doubao-seedance-2.0",
  "prompt": "動画のスタイルをアニメ風に変換する",
  "video_urls": ["https://example.com/reference.mp4"]
}

​
ケース 5：参照動画 + 参照音声

{
  "model": "doubao-seedance-2.0",
  "prompt": "人物が話しているシーン",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

​
ケース 6：音声付き動画

{
  "model": "doubao-seedance-2.0",
  "prompt": "男性が女性を呼び止めて言う：「覚えておいて、これからは指で月を指してはいけないよ。」",
  "generate_audio": true
}

​
ケース 7：連続動画生成（最後のフレームを返す）

{
  "model": "doubao-seedance-2.0",
  "prompt": "子猫がカメラに向かって歩き続ける",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}

​
ケース 8：高速版生成

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "都市の夜景タイムラプス撮影",
  "size": "21:9",
  "duration": 8
}
タスク結果の照会動画生成は非同期タスクで、送信時に task_id を返します。タスクステータス取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。

​
1.5 Proバージョンとの違い

機能1.5 Pro2.0 / 2.0 fast
解像度480p/720p/1080p480p/720p
長さ範囲4-12秒5-15秒
デフォルト長さ5秒5秒
アスペクト比パラメータaspect_ratiosize（adaptive 自適応を追加）
音声生成audio パラメータgenerate_audio パラメータ
参照動画非サポートvideo_urls サポート
参照音声非サポートaudio_urls サポート
画像から動画image_urls / image_with_rolesimage_urls / image_with_roles
音声付き動画非サポートgenerate_audio サポート
連続動画非サポートreturn_last_frame サポート
高速版非サポートdoubao-seedance-2.0-fast サポート