メインコンテンツへスキップ
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"
    }
  ]
}

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 --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 - 高速版、スタンダード版と同じ機能で、生成速度がより高速
  • doubao-seedance-2.0-face - 実写人物アップロード対応、スタンダード版と同じ機能
  • doubao-seedance-2.0-fast-face - 実写人物アップロード対応、高速版と同じ機能
prompt
string
動画コンテンツの説明テキストから動画の場合は必須、画像から動画/動画参照生成の場合はオプション主題、アクション、カメラワーク、スタイルを明確に記述すると、より良い生成結果が得られます
プロンプトは 4000 文字まで入力できますが、500 文字程度を推奨します。
例:"子猫がカメラに向かってあくびをする"
duration
integer
デフォルト:"5"
動画の長さ(秒)サポート範囲:4 ~ 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 - 高画質
  • 1080p - フルHD(doubao-seedance-2.0-face および doubao-seedance-2.0 のみ対応)
デフォルト:480p
seed
integer
ランダムシード、生成コンテンツのランダム性を制御するために使用
  • 同じリクエストで異なる seed 値を受け取ると、異なる結果が生成されます
  • 同じリクエストで同じ seed 値を受け取ると、類似の結果が生成されますが、完全に一致することは保証されません
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配列、画像から動画に使用2種類の形式をサポート:
  • 通常の画像URL:https://example.com/cat.jpg
  • Asset URL(審査済み素材):asset://asset_a
例:["https://example.com/cat.jpg"] または ["asset://asset_a"]
Asset URL は doubao-seedance-2.0 および doubao-seedance-2.0-fast モデルのみ対応しています。その他のモデルでは使用できません。
  • image_urlsimage_with_roles は同時に使用できません
  • 最大9枚の参照画像
image_with_roles
array
ロール付き画像配列、最初のフレーム/最後のフレームの指定をサポート
url フィールドに Asset URL を使用する場合、doubao-seedance-2.0 および doubao-seedance-2.0-fast モデルのみ対応しています。その他のモデルでは使用できません。
例:
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
Asset URL の書き方:
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
  • image_urlsimage_with_roles は同時に使用できません
  • 最初/最後のフレーム画像を使用する場合、video_urlsaudio_urls は使用できません
video_urls
array<string>
参照動画URL配列2種類の形式をサポート:
  • 通常の動画URL:https://example.com/reference.mp4
  • Asset URL(審査済み素材):asset://asset_a
例:["https://example.com/reference.mp4"] または ["asset://asset_a"]
Asset URL は doubao-seedance-2.0 および doubao-seedance-2.0-fast モデルのみ対応しています。その他のモデルでは使用できません。
  • 最初/最後のフレーム画像(image_with_roles)を使用する場合、参照動画は使用できません
  • 最大3つの参照動画、合計時間 ≤ 15s
  • 参照動画の解像度は 480P ~ 720P の範囲である必要があります
  • 参照動画に実在の人物を含めることはできません
audio_urls
array<string>
参照音声URL配列2種類の形式をサポート:
  • 通常の音声URL:https://example.com/speech.wav
  • Asset URL(審査済み素材):asset://asset_a
例:["https://example.com/speech.wav"] または ["asset://asset_a"]
Asset URL は doubao-seedance-2.0 および doubao-seedance-2.0-fast モデルのみ対応しています。その他のモデルでは使用できません。
  • 最初/最後のフレーム画像(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
}

ケース 9:参照画像 + 参照動画 + 参照音声(マルチモーダル動画)

参照画像、参照動画、参照音声を組み合わせて、没入感のある一人称視点の広告動画を生成します。商品プロモーション、ブランド広告など、複数素材の融合が必要なシーンに最適です。
{
  "model": "doubao-seedance-2.0",
  "prompt": "全編を通して動画1の一人称視点の構図を使用し、全編を通して音声1をBGMとして使用する。一人称視点のフルーツティー宣伝広告、seedanceブランド「苹苹安安」アップルフルーツティー限定版。最初のフレームは画像1:あなたの手が朝露のついたアクスの赤リンゴを摘み、鮮明なリンゴの衝突音。2-4秒:素早いカット切替、あなたの手がリンゴの塊をシェーカーカップに投入し、氷とお茶ベースを加え、力強く振る。氷の衝突音と振る音が軽快なドラムビートに合わせる、背景音:「新鮮カット、新鮮シェイク」。4-6秒:一人称完成品クローズアップ、層状のフルーツティーを透明カップに注ぎ、あなたの手がクリームキャップを上部に軽く絞り出して広げ、カップにピンクのラベルを貼り、カメラがクリームキャップとフルーツティーの層状テクスチャにズームイン。6-8秒:一人称手持ちカップを掲げる、画像2のフルーツティーをカメラに向けて持ち上げる(視聴者に差し出す視点をシミュレート)、カップのラベルがはっきり見える、背景音「さわやかな一口をどうぞ」、最終フレームは画像2で静止。背景音声は一貫して女性の音色を使用。",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

ケース 10:Asset URL を使用した画像から動画

審査済みのバーチャルアバター素材を参照画像として直接渡すことができ、再アップロードや再審査は不要です。
{
  "model": "doubao-seedance-2.0",
  "prompt": "人物が明るい陽光の中、都市の街路を自然に歩く",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

ケース 11:Asset URL で参照ポートレートを指定(image_with_roles)

{
  "model": "doubao-seedance-2.0",
  "prompt": "参照ポートレートを使用して、人物がエレガントにカメラに向かって歩く",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

ケース 12:高速版 + Asset URL 画像から動画

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "人物が公園を散歩し、そよ風が吹く",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

ケース 13:Asset URL 画像 + 参照動画(モーション転送)

審査済みの人物素材と参照動画を組み合わせて、指定した動作を行うよう人物を誘導します。
{
  "model": "doubao-seedance-2.0",
  "prompt": "人物が参照動画のリズムに合わせて踊り、動作がスムーズで自然",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
タスク結果の照会動画生成は非同期タスクで、送信時に task_id を返します。タスクステータス取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。

1.5 Proバージョンとの違い

特性1.5 Pro2.0 / 2.0 fast
解像度480p/720p/1080p480p/720p
長さ範囲4-12秒5-15秒
デフォルト長さ5秒5秒
アスペクト比パラメータaspect_ratiosizeadaptive 自適応を追加)
音声生成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 サポート