seedance-2 動画生成

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "Keep the character from image 1, follow the camera motion of video 1, and match the rhythm of audio 1 for a short indoor product clip.",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "Slowly push from the bouquet by the window toward the dining table, keeping a warm and soft look.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/first-frame.png", "role": "first_frame"},
      {"url": "https://example.com/last-frame.png", "role": "last_frame"}
    ],
    "resolution": "720p",
    "generate_audio": false
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-mini",
        "prompt": "Keep the same character and use the reference image and video rhythm to create a short indoor ad clip",
        "duration": 8,
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "image_with_roles": [
            {"url": "https://example.com/ref.png", "role": "reference_image"}
        ],
        "video_with_roles": [
            {"url": "https://example.com/ref.mp4", "role": "reference_video"}
        ],
    },
)

print(response.json())

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}

POST

videos

generations

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "Keep the character from image 1, follow the camera motion of video 1, and match the rhythm of audio 1 for a short indoor product clip.",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "Slowly push from the bouquet by the window toward the dining table, keeping a warm and soft look.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/first-frame.png", "role": "first_frame"},
      {"url": "https://example.com/last-frame.png", "role": "last_frame"}
    ],
    "resolution": "720p",
    "generate_audio": false
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-mini",
        "prompt": "Keep the same character and use the reference image and video rhythm to create a short indoor ad clip",
        "duration": 8,
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "image_with_roles": [
            {"url": "https://example.com/ref.png", "role": "reference_image"}
        ],
        "video_with_roles": [
            {"url": "https://example.com/ref.mp4", "role": "reference_video"}
        ],
    },
)

print(response.json())

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}

中国本土のユーザー向け： 中国本土のユーザーは https://toapis.cn を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

Supports seedance-2, seedance-2-fast, and seedance-2-mini
Supports text-to-video, first-frame / first-last-frame image-to-video, and multimodal reference-to-video; seedance-2-mini also supports frame roles and the audio generation switch
Supports combined image, video, and audio references; seedance-2-mini allows up to 9 images, 3 videos, and 3 audios
Async task workflow: the submit API returns generation.task, and the completed result is fetched from the task status API

Authorizations

string

必須

All requests require Bearer Token authentication.Get your API Key from the API Key Management Page.

Authorization: Bearer YOUR_API_KEY

Body

string

デフォルト:"seedance-2"

必須

Video generation model name.Available models:

seedance-2 - Standard version for higher quality output and the broader Seedance 2 workflow
seedance-2-fast - Faster version for previews and lower-latency iteration
seedance-2-mini - Lightweight version for lower-cost drafts and multimodal reference workflows, currently fixed to 1 result per request

string

Video prompt.We recommend clearly describing the scene, camera motion, subject action, style, and audio mood.

string

Your business-side ID, such as an order number or internal job ID. Once submitted, it is stored with the task and can be used later for status lookup: GET /v1/videos/generations/{client_business_id}.metadata.client_business_id is also accepted, but the top-level field is recommended.

boolean

デフォルト:false

省略可能, 既定値は false. メディア入力のあるリクエスト用です. true では通常の規則でチャネルを選択します. 素材ライブラリに対応するチャネルは素材の準備と審査を自動で行い, 必要な審査がすべて通過してから動画を送信します. その他のチャネルは素材審査を省略し, 従来のメディア処理を行います. HTTP は先に動画タスクを返します. 審査用の画像は URL と Base64, 動画と音声は HTTP(S) に対応し, モデル本来の形式制限も適用されます. 新モードの asset:// は HTTP 400 です. 省略または false では従来の動作を維持します.例, 入力優先順位, 再利用の規則はオンデマンド素材審査を参照してください.

integer

デフォルト:0

Video duration in seconds.Rules:

seedance-2: 4-15
seedance-2-fast: 4-15
seedance-2-mini: 4-15
0: auto duration (seedance-2 / seedance-2-fast only)
-1: auto duration (seedance-2 / seedance-2-fast only)

string

Video aspect ratio.Options:

21:9
16:9
4:3
1:1
3:4
9:16
adaptive

adaptive lets the upstream choose an appropriate ratio from the input media.

string[]

Compatibility image URL array.We recommend using image_with_roles instead so you can explicitly mark first_frame, last_frame, or reference_image.

Do not use image_urls together with image_with_roles.
For new integrations, use image_with_roles to explicitly mark how each image should be used.

array

Image list with explicit roles.Supported patterns:

seedance-2 / seedance-2-fast / seedance-2-mini
- first_frame for first-frame image-to-video
- first_frame + last_frame for first-last-frame video generation
- reference_image for multimodal reference generation

表示 Field details

string

必須

Image URL, Base64 data, or uploaded asset URI.Supported:

https://...
data:image/<format>;base64,...
asset://<ASSET_ID>

string

必須

Image role.Allowed values:

first_frame
last_frame
reference_image

Maximum 1 first_frame
Maximum 1 last_frame
Maximum 9 reference_image
Frame mode and reference mode cannot be mixed
seedance-2-mini also supports first_frame, last_frame, and reference_image

array

Video list with roles.Only reference_video is currently supported in multimodal reference mode.

表示 Field details

string

必須

Video URL or uploaded asset URI.

string

必須

Fixed to:

reference_video

Limits:

seedance-2-mini: up to 3 reference videos

array

Audio list with roles.Only reference_audio is currently supported in multimodal reference mode.

表示 Field details

string

必須

Audio URL, Base64 data, or uploaded asset URI.

string

必須

Fixed to:

reference_audio

Limits:

seedance-2-mini: up to 3 reference audios

audio_with_roles cannot be used alone. At least one visual input is required.

string

デフォルト:"720p"

Video resolution.Options:

seedance-2: 480p, 720p, 1080p, 4k
seedance-2-fast: 480p, 720p
seedance-2-mini: 480p, 720p

boolean

デフォルト:true

Whether to generate synced audio.seedance-2-mini also supports this field.

boolean

デフォルト:false

生成動画の最終フレーム画像を返すかどうか。true の場合、完了したタスクの result.data[0].last_frame_url に画像 URL が返されます。

array

モデルが使用できるツール。Seedance 2 シリーズでは現在 Web 検索をサポートします。

[{ "type": "web_search" }]

実際の検索回数は usage.tool_usage.web_search に返され、0 は検索が実行されなかったことを示します。

tools はテキストから動画を生成するリクエスト専用で、画像・動画・音声入力とは併用できません。

integer

Random seed for generation control.

string

ToAPIs 標準完了 callback。Token URL と secret を先に設定し、同一 origin のみ上書きできます。Webhook。

string

呼び出し側の追跡フィールド。Webhook 設定には依存しません。

Use Uploaded Assets

If you already uploaded private assets and obtained a usable asset_id, you do not need to send the original media URL again. Use:

asset://<ASSET_ID>

Asset inputs can be used as:

Images: first_frame, last_frame, reference_image
Videos: reference_video
Audios: reference_audio

Before use, make sure the asset has reached active status. Related guides:

Input Combinations

Typical supported combinations:

Text only: text-to-video
Text + first frame: first-frame image-to-video
Text + first frame + last frame: first-last-frame generation
Text + reference images: multimodal reference generation
Text + reference video: video-reference generation
Text + reference images + reference audio: multimodal reference generation
Text + reference images + reference video + reference audio: multimodal reference generation

seedance-2-mini also supports first-frame and first-last-frame workflows. Use image_with_roles with explicit first_frame / last_frame roles.

Capabilities

Item	seedance-2	seedance-2-fast	seedance-2-mini
Positioning	Higher quality and longer runs	Faster generation and lower latency	Lower-cost drafts and multimodal reference
Duration	`4-15` seconds, auto duration supported	`4-15` seconds, auto duration supported	`4-15` seconds
Resolution	`480p` / `720p` / `1080p` / `4k`	`480p` / `720p`	`480p` / `720p`
Image roles	`first_frame` / `last_frame` / `reference_image`	`first_frame` / `last_frame` / `reference_image`	`first_frame` / `last_frame` / `reference_image`
Video roles	`reference_video`	`reference_video`	`reference_video`
Audio roles	`reference_audio`	`reference_audio`	`reference_audio`
Frame mode	Supported	Supported	Supported
Reference image limit	`9`	`9`	`9`
Reference video limit	Depends on the routed channel	Depends on the routed channel	`3`
Reference audio limit	Depends on the routed channel	Depends on the routed channel	`3`
Synced audio field	`generate_audio`	`generate_audio`	`generate_audio`
ToAPIs callback	`callback_url`（`trace_id` は任意）	`callback_url`（`trace_id` は任意）	`callback_url`（`trace_id` は任意）

seedance-2-mini is currently fixed to 1 output per request and does not expose count / n. Express frame control through image_with_roles using first_frame / last_frame.

レスポンス

string

Task ID for status queries.

string

Your business-side ID. Returned only when client_business_id was provided in the request.

string

Object type, always generation.task.

string

モデル name used for this request.

string

Task status: queued, in_progress, completed, or failed.

integer

Task progress percentage (0-100).

integer

Task creation timestamp.

The submit API returns the base task object. After completion, use Get Video Task ステータス to fetch completed_at, expires_at, and result.type = "video" with result.data[].url and result.data[].format. return_last_frame 使用時は result.data[0].last_frame_url、web_search 使用時は usage.tool_usage.web_search も返されます。

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "Keep the character from image 1, follow the camera motion of video 1, and match the rhythm of audio 1 for a short indoor product clip.",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "Slowly push from the bouquet by the window toward the dining table, keeping a warm and soft look.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/first-frame.png", "role": "first_frame"},
      {"url": "https://example.com/last-frame.png", "role": "last_frame"}
    ],
    "resolution": "720p",
    "generate_audio": false
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-mini",
        "prompt": "Keep the same character and use the reference image and video rhythm to create a short indoor ad clip",
        "duration": 8,
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "image_with_roles": [
            {"url": "https://example.com/ref.png", "role": "reference_image"}
        ],
        "video_with_roles": [
            {"url": "https://example.com/ref.mp4", "role": "reference_video"}
        ],
    },
)

print(response.json())

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}

概要

クイックスタート

モデル一覧

チャットAPI

画像API

動画API

音楽API

タスク管理

ファイルアップロード

アカウント

よくある質問

Authorizations

Body

Use Uploaded Assets

Input Combinations

Capabilities

レスポンス

​Authorizations

​Body

​Use Uploaded Assets

​Input Combinations

​Capabilities

​レスポンス

Authorizations

Body

Use Uploaded Assets

Input Combinations

Capabilities

レスポンス