# Doubao Seedance 2.5 260628 Global Video Generation

> Video Generation

Submit an asynchronous video generation task.

## Endpoint

`POST https://api.modelverse.cn/v1/tasks/submit`

## Request Body

## Responses

- **200** — Task submitted successfully.
- **400** — Invalid request parameters.
- **default** — Error response.

## OpenAPI Definition

```json
{
  "openapi": "3.1.0",
  "x-language": "en-US",
  "info": {
    "title": "ModelVerse doubao-seedance-2-5-260628-global Video Task API",
    "version": "1.0.0",
    "description": "OpenAPI 3.1 schema for the ModelVerse `doubao-seedance-2-5-260628-global`\nasynchronous video generation task API. Covers submitting a task, querying\ntask status, and cancelling a task (`GET /v1/tasks/cancel`).\n"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn",
      "description": "ModelVerse API endpoint documented for this model."
    }
  ],
  "tags": [
    {
      "name": "doubao-seedance-2-5-260628-global",
      "description": "Asynchronous video task operations for doubao-seedance-2-5-260628-global."
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/tasks/submit": {
      "post": {
        "tags": [
          "doubao-seedance-2-5-260628-global"
        ],
        "operationId": "submitDoubaoSeedance20260628Task",
        "summary": "Doubao Seedance 2.5 260628 Global Video Generation",
        "description": "Submit an asynchronous video generation task.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DoubaoSeedance20260628TaskSubmitRequest"
              },
              "examples": {
                "textAndFirstFrame": {
                  "summary": "Text prompt with a first-frame image",
                  "value": {
                    "model": "doubao-seedance-2-5-260628-global",
                    "input": {
                      "content": [
                        {
                          "type": "text",
                          "text": "让他跑起来。"
                        },
                        {
                          "type": "image_url",
                          "image_url": {
                            "url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg"
                          },
                          "role": "first_frame"
                        }
                      ]
                    },
                    "parameters": {
                      "duration": 5,
                      "resolution": "720p",
                      "ratio": "adaptive",
                      "generate_audio": false
                    }
                  }
                },
                "withReferenceVideoAndAudio": {
                  "summary": "Request with text, image, reference video, and reference audio",
                  "value": {
                    "model": "doubao-seedance-2-5-260628-global",
                    "input": {
                      "content": [
                        {
                          "type": "text",
                          "text": "让他跑起来。"
                        },
                        {
                          "type": "image_url",
                          "image_url": {
                            "url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg"
                          },
                          "role": "first_frame"
                        },
                        {
                          "type": "video_url",
                          "video_url": {
                            "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
                          },
                          "role": "reference_video"
                        },
                        {
                          "type": "audio_url",
                          "audio_url": {
                            "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
                          },
                          "role": "reference_audio"
                        }
                      ]
                    },
                    "parameters": {
                      "execution_expires_after": 3600,
                      "generate_audio": true,
                      "resolution": "720p",
                      "ratio": "adaptive",
                      "duration": 30,
                      "camera_fixed": false,
                      "watermark": false,
                      "callback_url": "https://ark-project.tos-cn-beijing.volces.com"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Task submitted successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628TaskSubmitResponse"
                },
                "examples": {
                  "submitted": {
                    "summary": "Submitted task",
                    "value": {
                      "output": {
                        "task_id": "task_id"
                      },
                      "request_id": "request_id"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorResponse"
                },
                "examples": {
                  "invalidParameter": {
                    "$ref": "#/components/examples/DoubaoSeedance20260628InvalidParameterError"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorResponse"
                },
                "examples": {
                  "error": {
                    "$ref": "#/components/examples/DoubaoSeedance20260628InvalidParameterError"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/status": {
      "get": {
        "tags": [
          "doubao-seedance-2-5-260628-global"
        ],
        "operationId": "getDoubaoSeedance20260628TaskStatus",
        "summary": "Doubao Seedance 2.5 260628 Global Task Status",
        "description": "Query the status, result URLs, and usage details for an asynchronous video task.",
        "parameters": [
          {
            "name": "task_id",
            "in": "query",
            "required": true,
            "description": "Asynchronous task identifier returned by `/v1/tasks/submit`.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "taskId": {
                "value": "task_id"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Task status response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628TaskStatusResponse"
                },
                "examples": {
                  "success": {
                    "summary": "Successful task",
                    "value": {
                      "output": {
                        "task_id": "xxxxxxx",
                        "task_status": "Success",
                        "urls": [
                          "http://xxxxxxxx/xx.mp4"
                        ],
                        "submit_time": 1768460826,
                        "finish_time": 1768460932
                      },
                      "usage": {
                        "completion_tokens": 108900,
                        "total_tokens": 108900,
                        "duration": 5
                      },
                      "request_id": ""
                    }
                  },
                  "failure": {
                    "summary": "Failed task",
                    "value": {
                      "output": {
                        "task_id": "xxxxxxx",
                        "task_status": "Failure",
                        "submit_time": 1756959000,
                        "finish_time": 1756959019,
                        "error_message": "error_message"
                      },
                      "usage": {
                        "completion_tokens": 0,
                        "total_tokens": 0,
                        "duration": 5
                      },
                      "request_id": ""
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid task identifier or request parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorResponse"
                },
                "examples": {
                  "invalidParameter": {
                    "$ref": "#/components/examples/DoubaoSeedance20260628InvalidParameterError"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorResponse"
                },
                "examples": {
                  "error": {
                    "$ref": "#/components/examples/DoubaoSeedance20260628InvalidParameterError"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/cancel": {
      "get": {
        "tags": [
          "doubao-seedance-2-5-260628-global"
        ],
        "operationId": "cancelDoubaoSeedance20260628Task",
        "summary": "Doubao Seedance 2.5 260628 Global Task Cancellation",
        "description": "Cancel (delete) an asynchronous task. This operation is supported only by\nDoubao Seedance series models. Only tasks that have not started running can\nbe cancelled; a task that is currently running cannot be cancelled and\nreturns a 500 error.\n",
        "parameters": [
          {
            "name": "task_id",
            "in": "query",
            "required": true,
            "description": "Identifier of the asynchronous task to cancel, returned by `/v1/tasks/submit`.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "taskId": {
                "value": "cgt-20260812234045-g886s"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Task cancelled.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628CancelResponse"
                },
                "examples": {
                  "deleted": {
                    "summary": "Cancelled successfully",
                    "value": {
                      "deleted": true,
                      "id": "cgt-20260812234045-g886s",
                      "object": "video.deleted"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "The task is currently running and cannot be cancelled.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorResponse"
                },
                "examples": {
                  "runningTask": {
                    "$ref": "#/components/examples/DoubaoSeedance20260628CancelConflictError"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorResponse"
                },
                "examples": {
                  "error": {
                    "$ref": "#/components/examples/DoubaoSeedance20260628CancelConflictError"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "ModelVerse API key sent as `Authorization: Bearer <MODELVERSE_API_KEY>`."
      }
    },
    "schemas": {
      "DoubaoSeedance20260628TaskSubmitRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "input"
        ],
        "properties": {
          "model": {
            "type": "string",
            "const": "doubao-seedance-2-5-260628-global",
            "description": "Model name. Fixed to `doubao-seedance-2-5-260628-global` for this API document."
          },
          "input": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628Input"
          },
          "parameters": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628Parameters"
          }
        }
      },
      "DoubaoSeedance20260628Input": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "content"
        ],
        "properties": {
          "content": {
            "type": "array",
            "minItems": 1,
            "description": "Information objects used to generate the video. The source document defines\ntext, image, reference video, and reference audio object schemas. It also\nmentions a sample-video mode, but does not define that object's fields; sample\nmode must not be mixed with text or image objects.\n",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628TextContent"
                },
                {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628ImageUrlContent"
                },
                {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628VideoUrlContent"
                },
                {
                  "$ref": "#/components/schemas/DoubaoSeedance20260628AudioUrlContent"
                }
              ]
            }
          }
        }
      },
      "DoubaoSeedance20260628TextContent": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "text",
            "description": "Input content type for text information."
          },
          "text": {
            "type": "string",
            "minLength": 1,
            "description": "Text prompt describing the expected video. Chinese and English are supported; no more than 500 Chinese characters is recommended."
          }
        }
      },
      "DoubaoSeedance20260628ImageUrlContent": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "image_url",
            "description": "Input content type for image information."
          },
          "image_url": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628ImageUrlObject"
          },
          "role": {
            "type": "string",
            "description": "Image position or usage. With one image object, this may be omitted or set to\n`first_frame`. With two image objects, this is required: use `first_frame` for\nthe first frame and `last_frame` for the last frame. Use `reference_image` for\na reference image.\n",
            "enum": [
              "first_frame",
              "last_frame",
              "reference_image"
            ]
          }
        }
      },
      "DoubaoSeedance20260628ImageUrlObject": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Image URL or Base64 data URL. For Base64 input, use\n`data:image/<format>;base64,<Base64 data>` and keep `<format>` lowercase,\nfor example `data:image/png;base64,{base64_image}`.\n"
          }
        }
      },
      "DoubaoSeedance20260628VideoUrlContent": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "video_url",
          "role"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "video_url",
            "description": "Input content type for reference video information."
          },
          "video_url": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628VideoUrlObject"
          },
          "role": {
            "type": "string",
            "const": "reference_video",
            "description": "Fixed value for reference video information."
          }
        }
      },
      "DoubaoSeedance20260628VideoUrlObject": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Reference video URL. Ensure the URL is accessible."
          }
        }
      },
      "DoubaoSeedance20260628AudioUrlContent": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "audio_url",
          "role"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "audio_url",
            "description": "Input content type for reference audio information."
          },
          "audio_url": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628AudioUrlObject"
          },
          "role": {
            "type": "string",
            "const": "reference_audio",
            "description": "Fixed value for reference audio information."
          }
        }
      },
      "DoubaoSeedance20260628AudioUrlObject": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Reference audio URL. Ensure the URL is accessible."
          }
        }
      },
      "DoubaoSeedance20260628Parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "execution_expires_after": {
            "type": "integer",
            "minimum": 3600,
            "maximum": 259200,
            "default": 172800,
            "description": "Task expiration threshold in seconds after submission. Defaults to 172800 seconds, or 48 hours."
          },
          "generate_audio": {
            "type": "boolean",
            "default": false,
            "description": "Whether the generated video includes synchronized audio."
          },
          "resolution": {
            "type": "string",
            "default": "720p",
            "description": "Video resolution. Supported values are `480p`, `720p`, and `1080p`. Sample-video mode supports only `480p`.",
            "enum": [
              "480p",
              "720p",
              "1080p"
            ]
          },
          "ratio": {
            "type": "string",
            "default": "adaptive",
            "description": "Generated video aspect ratio. `adaptive` lets the model choose the most suitable aspect ratio.",
            "enum": [
              "16:9",
              "4:3",
              "1:1",
              "3:4",
              "9:16",
              "21:9",
              "adaptive"
            ]
          },
          "duration": {
            "type": "integer",
            "minimum": 4,
            "maximum": 30,
            "default": 5,
            "description": "Generated video duration in seconds; supports 4-30 seconds."
          },
          "seed": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Random seed."
          },
          "camera_fixed": {
            "type": "boolean",
            "default": false,
            "description": "Whether to fix the camera."
          },
          "watermark": {
            "type": "boolean",
            "default": false,
            "description": "Whether the generated video includes a watermark."
          },
          "callback_url": {
            "type": "string",
            "format": "uri",
            "description": "Callback URL for task status change notifications. ModelVerse sends POST requests to this URL when the video task status changes."
          },
          "seedance_tools": {
            "type": "array",
            "description": "Official Seedance tools. When enabled, the model can invoke the\ncorresponding tools during generation. Only web search (`web_search`)\nis currently supported.\n",
            "items": {
              "$ref": "#/components/schemas/DoubaoSeedance20260628Tool"
            }
          },
          "omni_reference_task_type": {
            "type": "string",
            "default": "auto",
            "description": "Task type guidance. Seedance 2.5 multimodal reference-to-video tasks include three subtask types: reference-to-video, video editing, and video extension. Different task types have specific parameter constraints. \nTo reduce the likelihood of asynchronous errors after task creation, you can use this parameter to specify the subtask type so that the corresponding constraints can be validated in advance.By default, omni_reference_task_type=auto. \nIn this mode, the model automatically determines the task type based on the input materials and prompt, and then validates the parameter values accordingly. \nIf the parameters are incompatible with the actual task type, the task will fail asynchronously with error code InvalidParameter.\nTaskTypeConstraint.When the task type is explicitly specified by setting omni_reference_task_type to reference, edit, or extend, the API validates the task-specific parameter constraints when the task is submitted. \nIf the parameters do not meet the requirements, the API returns an error immediately and the task is not created.\n",
            "enum": [
              "auto",
              "reference",
              "edit",
              "extend"
            ]
          }
        }
      },
      "DoubaoSeedance20260628Tool": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "web_search"
            ],
            "description": "Tool type. Only `web_search` is currently supported."
          }
        }
      },
      "DoubaoSeedance20260628TaskSubmitResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "output",
          "request_id"
        ],
        "properties": {
          "output": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "task_id"
            ],
            "properties": {
              "task_id": {
                "type": "string",
                "description": "Unique asynchronous task identifier."
              }
            }
          },
          "request_id": {
            "type": "string",
            "description": "Unique request identifier."
          }
        }
      },
      "DoubaoSeedance20260628CancelResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "deleted",
          "id",
          "object"
        ],
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the task was cancelled successfully."
          },
          "id": {
            "type": "string",
            "description": "Identifier of the cancelled task."
          },
          "object": {
            "type": "string",
            "const": "video.deleted",
            "description": "Object type. Fixed to `video.deleted`."
          }
        }
      },
      "DoubaoSeedance20260628TaskStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "output",
          "request_id"
        ],
        "properties": {
          "output": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628TaskStatusOutput"
          },
          "usage": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628Usage"
          },
          "request_id": {
            "type": "string",
            "description": "Unique request identifier."
          }
        }
      },
      "DoubaoSeedance20260628TaskStatusOutput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "task_id",
          "task_status"
        ],
        "properties": {
          "task_id": {
            "type": "string",
            "description": "Unique asynchronous task identifier."
          },
          "task_status": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628TaskStatus"
          },
          "urls": {
            "type": "array",
            "description": "Video result URL list.",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "submit_time": {
            "type": "integer",
            "format": "int64",
            "description": "Task submission Unix timestamp in seconds."
          },
          "finish_time": {
            "type": "integer",
            "format": "int64",
            "description": "Task completion Unix timestamp in seconds."
          },
          "error_message": {
            "type": "string",
            "description": "Error message returned when the task fails."
          }
        }
      },
      "DoubaoSeedance20260628TaskStatus": {
        "type": "string",
        "description": "Current asynchronous task status.",
        "enum": [
          "Pending",
          "Running",
          "Success",
          "Failure",
          "Expired"
        ]
      },
      "DoubaoSeedance20260628Usage": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "duration": {
            "type": "integer",
            "description": "Video duration in seconds."
          },
          "completion_tokens": {
            "type": "integer",
            "description": "Number of tokens charged for the generated output video."
          },
          "total_tokens": {
            "type": "integer",
            "description": "Total tokens consumed by this request. Video generation models do not count input tokens, so `total_tokens` equals `completion_tokens`."
          }
        }
      },
      "DoubaoSeedance20260628ErrorResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/components/schemas/DoubaoSeedance20260628ErrorObject"
          },
          "request_id": {
            "type": "string",
            "description": "Unique request identifier, if available."
          }
        }
      },
      "DoubaoSeedance20260628ErrorObject": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "message",
          "type"
        ],
        "properties": {
          "message": {
            "type": "string",
            "description": "Error message."
          },
          "type": {
            "type": "string",
            "description": "Error type."
          },
          "code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Error code."
          },
          "param": {
            "type": [
              "string",
              "null"
            ],
            "description": "Request parameter related to the error."
          },
          "trace_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Trace identifier, if available."
          }
        }
      }
    },
    "examples": {
      "DoubaoSeedance20260628InvalidParameterError": {
        "summary": "Invalid parameter error",
        "value": {
          "error": {
            "message": "Invalid param",
            "type": "invalid_request_error",
            "code": "param_error",
            "param": "parameters.duration"
          },
          "request_id": "request_id"
        }
      },
      "DoubaoSeedance20260628CancelConflictError": {
        "summary": "Task is running and cannot be cancelled",
        "value": {
          "error": {
            "message": "[trace_id: 5421e30f-3f5f-4164-a8d2-8950955183f0] Request llm server Error: volcengine cancel API error: status=409, body={\"error\":{\"code\":\"InvalidAction.RunningTaskDeletion\",\"message\":\"Cannot delete task `cgt-20260813104454-9m26b` because it is currently running.\",\"param\":\"\",\"type\":\"Conflict\"}}",
            "type": "internal_error",
            "param": null,
            "code": "model_server_error",
            "trace_id": "5421e30f-3f5f-4164-a8d2-8950955183f0"
          }
        }
      }
    }
  }
}
```