Skip to main content
Glama
AceDataCloud

SeedanceMCP

by AceDataCloud
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

seedance_generate_video

Turn any text prompt into an AI-generated video clip. Describe the scene, motion, style, or mood to create a video with URLs and metadata, no reference images required.

Instructions

Generate AI video from a text prompt using ByteDance Seedance.

This is the simplest way to create video - just describe what you want and
Seedance will generate a high-quality AI video.

Use this when:
- You want to create a video from a text description
- You don't have reference images
- You want quick text-to-video generation

For using reference images (first/last frame, reference), use
seedance_generate_video_from_image instead.

Returns:
    Task ID and generated video information including URLs and metadata.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
seedNoRandom seed for reproducible generation. Range: -1 to 4294967295. Use -1 for random. Default is -1.
modelNoModel version to use. Options: 'doubao-seedance-2-5-260628' (latest flagship, up to 30 seconds, multimodal reference, edit/extend, default), 'doubao-seedance-2-0-260128' (highest resolution, supports 4k), 'doubao-seedance-2-0-fast-260128' (latest generation, faster, up to 720p), 'doubao-seedance-2-0-mini-260615' (latest generation, lightweight, cheapest within the 2.0 series, up to 720p), 'doubao-seedance-1-5-pro-251215' (1.5 flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (1.0 standard), 'doubao-seedance-1-0-pro-fast-251015' (1.0 fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video).doubao-seedance-2-0-260128
ratioNoVideo aspect ratio. Options: '16:9' (landscape, default), '9:16' (portrait), '1:1' (square), '4:3', '3:4', '21:9' (ultrawide), 'adaptive'.16:9
toolsNoOptional Seedance 2.5 web search tool configuration.
framesNoFrame count for the generated video (1.0 series only). Must satisfy 25+4n (e.g. 29, 33, 37, ..., 289). Mutually exclusive with 'duration'.
promptYesDescription of the video to generate. Max 1000 characters. Be descriptive about the scene, motion, style, and mood. You can also include inline parameters like '--rs 720p --rt 16:9 --dur 5'. Examples: 'A cat walking through a garden with butterflies', 'Cinematic aerial shot of mountains at sunset'
durationNoVideo duration in seconds. 1.0 series: 2–12; 1.5 Pro: 4–12; 2.0 series: 4–15; 2.5: 4–30. Use -1 for auto-duration (1.5 Pro and 2.x). Default is 5. Mutually exclusive with 'frames'.
priorityNoSeedance 2.5 task priority from 0 to 9.
watermarkNoIf true, add a watermark to the video. Default is false.
resolutionNoVideo resolution. Options: '480p', '720p' (default), '1080p', '4k'. '4k' is supported only by 'doubao-seedance-2-0-260128'; '2-5' maxes out at '1080p'; '2-0-fast' and '2-0-mini' max out at '720p'.720p
callback_urlNoWebhook callback URL for asynchronous notifications. When provided, the API returns immediately with a task_id and calls this URL when the video is generated.
camera_fixedNoIf true, keep the camera fixed during generation. Default is false.
output_formatNoSeedance 2.5 output format: mp4 or mov.
generate_audioNoIf true, generate audio along with the video. Supported by 'doubao-seedance-1-5-pro-251215' and the 'doubao-seedance-2-0' series; other models ignore it. Approximately doubles the cost. Default is false.
return_last_frameNoIf true, also return the last frame of the generated video as an image URL. Useful for video extension workflows. Default is false.
safety_identifierNoStable anonymous end-user identifier. Do not use personal information.
execution_expires_afterNoTask timeout threshold in seconds. Default is 172800 (48 hours).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.1.10
    • addedInput schema / properties / execution_expires_after / maximum
      Added value: +259200
    • addedInput schema / properties / execution_expires_after / minimum
      Added value: +3600
  2. Changed6 schema fields changedv0.1.9
    • addedInput schema / $defs
      Added value: +{
+  "SeedanceWebSearchTool": {
+    "additionalProperties": false,
+    "description": "Seedance web search tool configuration.",
+    "properties": {
+      "limit": {
+        "default": 10,
+        "maximum": 50,
+        "minimum": 1,
+        "title": "Limit",
+        "type": "integer"
+      },
+      "max_keyword": {
+        "anyOf": [
+          {
+            "maximum": 50,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Max Keyword"
+      },
+      "sources": {
+        "anyOf": [
+          {
+            "items": {
+              "enum": [
+                "toutiao",
+                "douyin",
+                "moji",
+                "search_engine"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Sources"
+      },
+      "type": {
+        "const": "web_search",
+        "title": "Type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "title": "SeedanceWebSearchTool",
+    "type": "object"
+  }
+}
    • addedInput schema / properties / priority
      Added value: +{
+  "default": 0,
+  "description": "Seedance 2.5 task priority from 0 to 9.",
+  "maximum": 9,
+  "minimum": 0,
+  "title": "Priority",
+  "type": "integer"
+}
    • changedInput schema / properties / resolution / description
      Previous value: -"Video resolution. Options: '480p', '720p' (default), '1080p', '4k'. '4k' is supported only by 'doubao-seedance-2-0-260128'; '2-0-fast' and '2-0-mini' max out at '720p'."New value: +"Video resolution. Options: '480p', '720p' (default), '1080p', '4k'. '4k' is supported only by 'doubao-seedance-2-0-260128'; '2-5' maxes out at '1080p'; '2-0-fast' and '2-0-mini' max out at '720p'."
    • addedInput schema / properties / safety_identifier
      Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 64,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Stable anonymous end-user identifier. Do not use personal information.",
+  "title": "Safety Identifier"
+}
    • changedInput schema / properties / tools / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "$ref": "#/$defs/SeedanceWebSearchTool"
+    },
+    "maxItems": 1,
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedInput schema / properties / tools / description
      Previous value: -"Optional Seedance 2.5 tool configuration objects."New value: +"Optional Seedance 2.5 web search tool configuration."
  3. Changed9 schema fields changedv0.1.8
    • changedInput schema / properties / duration / anyOf
      Previous value: -[
-  {
-    "maximum": 15,
-    "minimum": 2,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 30,
+    "minimum": -1,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedInput schema / properties / duration / description
      Previous value: -"Video duration in seconds. Range: 2-15 (Seedance 2.0 supports 4-15). Default is 5. Mutually exclusive with 'frames'."New value: +"Video duration in seconds. 1.0 series: 2–12; 1.5 Pro: 4–12; 2.0 series: 4–15; 2.5: 4–30. Use -1 for auto-duration (1.5 Pro and 2.x). Default is 5. Mutually exclusive with 'frames'."
    • changedInput schema / properties / frames / anyOf
      Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 289,
+    "minimum": 29,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedInput schema / properties / frames / description
      Previous value: -"Frame count for the generated video. Must satisfy 25+4n (e.g. 29, 33, 37, ..., 361). Mutually exclusive with 'duration'."New value: +"Frame count for the generated video (1.0 series only). Must satisfy 25+4n (e.g. 29, 33, 37, ..., 289). Mutually exclusive with 'duration'."
    • changedInput schema / properties / model / description
      Previous value: -"Model version to use. Options: 'doubao-seedance-2-0-260128' (latest generation, highest quality, supports 4k and multimodal reference, default), 'doubao-seedance-2-0-fast-260128' (latest generation, faster, up to 720p), 'doubao-seedance-2-0-mini-260615' (latest generation, lightweight, cheapest within the 2.0 series, up to 720p), 'doubao-seedance-1-5-pro-251215' (1.5 flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (1.0 standard), 'doubao-seedance-1-0-pro-fast-251015' (1.0 fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video)."New value: +"Model version to use. Options: 'doubao-seedance-2-5-260628' (latest flagship, up to 30 seconds, multimodal reference, edit/extend, default), 'doubao-seedance-2-0-260128' (highest resolution, supports 4k), 'doubao-seedance-2-0-fast-260128' (latest generation, faster, up to 720p), 'doubao-seedance-2-0-mini-260615' (latest generation, lightweight, cheapest within the 2.0 series, up to 720p), 'doubao-seedance-1-5-pro-251215' (1.5 flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (1.0 standard), 'doubao-seedance-1-0-pro-fast-251015' (1.0 fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video)."
    • changedInput schema / properties / model / enum
      Previous value: -[
-  "doubao-seedance-2-0-260128",
-  "doubao-seedance-2-0-fast-260128",
-  "doubao-seedance-2-0-mini-260615",
-  "doubao-seedance-1-5-pro-251215",
-  "doubao-seedance-1-0-pro-250528",
-  "doubao-seedance-1-0-pro-fast-251015",
-  "doubao-seedance-1-0-lite-t2v-250428",
-  "doubao-seedance-1-0-lite-i2v-250428"
-]New value: +[
+  "doubao-seedance-2-5-260628",
+  "doubao-seedance-2-0-260128",
+  "doubao-seedance-2-0-fast-260128",
+  "doubao-seedance-2-0-mini-260615",
+  "doubao-seedance-1-5-pro-251215",
+  "doubao-seedance-1-0-pro-250528",
+  "doubao-seedance-1-0-pro-fast-251015",
+  "doubao-seedance-1-0-lite-t2v-250428",
+  "doubao-seedance-1-0-lite-i2v-250428"
+]
    • addedInput schema / properties / output_format
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "mp4",
+        "mov"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Seedance 2.5 output format: mp4 or mov.",
+  "title": "Output Format"
+}
    • removedInput schema / properties / service_tier
      Removed value: -{
-  "default": "default",
-  "description": "Service tier. 'default' for standard processing, 'flex' for 50%% cheaper but slower processing. Default is 'default'.",
-  "enum": [
-    "default",
-    "flex"
-  ],
-  "title": "Service Tier",
-  "type": "string"
-}
    • addedInput schema / properties / tools
      Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional Seedance 2.5 tool configuration objects.",
+  "title": "Tools"
+}
  4. Changed9 schema fields changedv0.1.7
    • changedInput schema / properties / duration / anyOf
      Previous value: -[
-  {
-    "maximum": 12,
-    "minimum": 2,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 15,
+    "minimum": 2,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedInput schema / properties / duration / description
      Previous value: -"Video duration in seconds. Range: 2-12. Default is 5. Mutually exclusive with 'frames'."New value: +"Video duration in seconds. Range: 2-15 (Seedance 2.0 supports 4-15). Default is 5. Mutually exclusive with 'frames'."
    • changedInput schema / properties / frames / description
      Previous value: -"Frame count for the generated video. Must satisfy 25+4n (e.g. 29, 33, 37, ..., 289). Mutually exclusive with 'duration'."New value: +"Frame count for the generated video. Must satisfy 25+4n (e.g. 29, 33, 37, ..., 361). Mutually exclusive with 'duration'."
    • changedInput schema / properties / generate_audio / description
      Previous value: -"If true, generate audio along with the video. Only supported by 'doubao-seedance-1-5-pro-251215' model. Approximately doubles the cost. Default is false."New value: +"If true, generate audio along with the video. Supported by 'doubao-seedance-1-5-pro-251215' and the 'doubao-seedance-2-0' series; other models ignore it. Approximately doubles the cost. Default is false."
    • changedInput schema / properties / model / default
      Previous value: -"doubao-seedance-1-0-pro-250528"New value: +"doubao-seedance-2-0-260128"
    • changedInput schema / properties / model / description
      Previous value: -"Model version to use. Options: 'doubao-seedance-2-0-260128' (latest generation quality model), 'doubao-seedance-2-0-fast-260128' (latest generation fast model), 'doubao-seedance-1-5-pro-251215' (newest flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (standard, default), 'doubao-seedance-1-0-pro-fast-251015' (fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video)."New value: +"Model version to use. Options: 'doubao-seedance-2-0-260128' (latest generation, highest quality, supports 4k and multimodal reference, default), 'doubao-seedance-2-0-fast-260128' (latest generation, faster, up to 720p), 'doubao-seedance-2-0-mini-260615' (latest generation, lightweight, cheapest within the 2.0 series, up to 720p), 'doubao-seedance-1-5-pro-251215' (1.5 flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (1.0 standard), 'doubao-seedance-1-0-pro-fast-251015' (1.0 fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video)."
    • changedInput schema / properties / model / enum
      Previous value: -[
-  "doubao-seedance-1-5-pro-251215",
-  "doubao-seedance-1-0-pro-250528",
-  "doubao-seedance-1-0-pro-fast-251015",
-  "doubao-seedance-1-0-lite-t2v-250428",
-  "doubao-seedance-1-0-lite-i2v-250428",
-  "doubao-seedance-2-0-260128",
-  "doubao-seedance-2-0-fast-260128"
-]New value: +[
+  "doubao-seedance-2-0-260128",
+  "doubao-seedance-2-0-fast-260128",
+  "doubao-seedance-2-0-mini-260615",
+  "doubao-seedance-1-5-pro-251215",
+  "doubao-seedance-1-0-pro-250528",
+  "doubao-seedance-1-0-pro-fast-251015",
+  "doubao-seedance-1-0-lite-t2v-250428",
+  "doubao-seedance-1-0-lite-i2v-250428"
+]
    • changedInput schema / properties / resolution / description
      Previous value: -"Video resolution. Options: '480p', '720p' (default), '1080p'."New value: +"Video resolution. Options: '480p', '720p' (default), '1080p', '4k'. '4k' is supported only by 'doubao-seedance-2-0-260128'; '2-0-fast' and '2-0-mini' max out at '720p'."
    • changedInput schema / properties / resolution / enum
      Previous value: -[
-  "480p",
-  "720p",
-  "1080p"
-]New value: +[
+  "480p",
+  "720p",
+  "1080p",
+  "4k"
+]
  5. Addedv0.1.5
  6. Removedv0.1.3
  7. Changed2 schema fields changedv0.1.1
    • changedInput schema / properties / model / description
      Previous value: -"Model version to use. Options: 'doubao-seedance-1-5-pro-251215' (newest flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (standard, default), 'doubao-seedance-1-0-pro-fast-251015' (fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video)."New value: +"Model version to use. Options: 'doubao-seedance-2-0-260128' (latest generation quality model), 'doubao-seedance-2-0-fast-260128' (latest generation fast model), 'doubao-seedance-1-5-pro-251215' (newest flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (standard, default), 'doubao-seedance-1-0-pro-fast-251015' (fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video)."
    • changedInput schema / properties / model / enum
      Previous value: -[
-  "doubao-seedance-1-5-pro-251215",
-  "doubao-seedance-1-0-pro-250528",
-  "doubao-seedance-1-0-pro-fast-251015",
-  "doubao-seedance-1-0-lite-t2v-250428",
-  "doubao-seedance-1-0-lite-i2v-250428"
-]New value: +[
+  "doubao-seedance-1-5-pro-251215",
+  "doubao-seedance-1-0-pro-250528",
+  "doubao-seedance-1-0-pro-fast-251015",
+  "doubao-seedance-1-0-lite-t2v-250428",
+  "doubao-seedance-1-0-lite-i2v-250428",
+  "doubao-seedance-2-0-260128",
+  "doubao-seedance-2-0-fast-260128"
+]
  8. First observedv0.1.0

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the behavioral disclosure burden. It does add a Returns clause mentioning task ID, video URLs, and metadata, which hints at task-based behavior. However, it omits important operational traits such as generation taking significant time and the likely need to poll or wait for the final video.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loaded: action, use cases, alternative, and return summary come in a readable order. The 'simplest way / high-quality' sentence is slightly promotional and redundant with the first sentence, but it does not meaningfully inflate the length.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 17-parameter tool, the input schema covers most details and an output schema presumably documents return structure. The description covers primary use cases and sibling routing, but it does not explain how to retrieve the final result, e.g., via seedance_get_task, or warn about long-running generation. It is adequate but has clear gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the schema already documents all 17 parameters with defaults, enums, and model-specific constraints. The description adds little beyond identifying the prompt as the core input and clarifying this is the text-only variant, so the parameter burden is adequately carried by the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Generate AI video from a text prompt using ByteDance Seedance.' It also names the sibling seedance_generate_video_from_image, so an agent can immediately distinguish text-to-video generation from image-conditioned generation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'Use this when' bullets clearly define the conditions: creating video from text, no reference images, and quick text-to-video generation. It explicitly directs image-reference workflows to seedance_generate_video_from_image instead, which is excellent routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools