> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 1.0 Pro 文生视频

> Seedance 1.0 Pro API 可根据文字描述生成 5 秒或 10 秒的视频场景，输出最高 1080p。

> [!TIP]
>
> 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。
> 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.vidgo.ai/zh/api-manual/task-management/status.md)接口获取结果。

使用 Seedance 1.0 Pro 根据文字描述生成 5 秒或 10 秒的视频场景，输出最高 1080p。

## 模型

* **bytedance/seedance/v1/pro/text-to-video** - 根据文本提示词生成视频场景。

## 功能

* 根据文本提示词生成视频场景。
* 输出分辨率可选 `720p`、`1080p`。

## 时长选项

* **5、10 秒** - 将 `duration` 设为数值整数。可选。仅在省略时默认为 **5 秒**。字符串、布尔值、null 和小数会被拒绝。`5.0` 这样的数值等同于 `5`。

## 高级参数

`model` 和可选的 `callback_url` 放在请求根级。所有工作流参数（包括输出选项）都放在 `input` 中。

只传本工作流支持的 input 字段。不支持的 `input` 字段会在扣除积分前被拒绝。默认值仅在省略可选 input 字段时生效；显式传入 null 或空值会被拒绝。

### 提示词

* `prompt`：必填字符串。描述场景和期望的运动。去除首尾空白后，长度必须为 **1-10,000 个 Unicode 字符**。非字符串值会被拒绝。
* 传入时值不能为空白。

### 分辨率

* `resolution`：可选。可选值：`720p`、`1080p`。仅在省略时默认为 `720p`。别名、大小写不同、带首尾空白或数值形式的值都会被拒绝。

## 计费因素

计费取决于输出分辨率（`resolution`）和视频时长（`duration`）。文生视频和图生视频使用相同费率。

积分在提交时扣除，任务失败时退还。


## OpenAPI

````yaml zh/api-manual/video-series/bytedance-seedance-v1-pro-text-to-video.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Seedance 1.0 Pro 文生视频
  description: 使用 Seedance 1.0 Pro 根据文字描述生成 5 秒或 10 秒的视频场景，输出最高 1080p。
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Video Series
      summary: Seedance 1.0 Pro 文生视频
      description: >-
        按文档说明的输入类型和取值传参。prompt 必须是字符串，去除首尾空白后为 1–10,000 个 Unicode 字符。duration
        必须是数值 5 或 10，字符串和小数会被拒绝。resolution 必须是 720p 或 1080p。
      operationId: submit_bytedance_seedance_v1_pro_text_to_video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              additionalProperties: true
              properties:
                model:
                  type: string
                  example: bytedance/seedance/v1/pro/text-to-video
                input:
                  type: object
                  required:
                    - prompt
                  description: 生成所需的输入参数
                  properties:
                    prompt:
                      type: string
                      description: 必填字符串；先去除首尾空白，再校验长度为 1–10,000 个 Unicode 字符。
                      maxLength: 10000
                      example: >-
                        One continuous cinematic five-second shot inside a
                        Nordic night sleeper-train compartment. An adult Nordic
                        woman with fair skin and a charcoal wool sweater sits in
                        three-quarter profile at the window, her hands resting
                        on her lap. Outside, a blizzard and dark conifer trunks
                        stream past. Begin as a medium shot of her quiet face
                        and the window, then slowly push in until the glass
                        fills the frame. Warm amber cabin lamps and cold blue
                        snowlight must stay physically consistent on the glass
                        as layered reflections. Keep her anatomy, sweater knit,
                        and seat geometry stable. No cuts, no other passengers,
                        no readable text, no logos, no brands, no advertising,
                        no watermark.
                      minLength: 1
                    resolution:
                      type: string
                      description: 仅支持 720p 或 1080p。仅在省略时默认为 720p；别名、null 和空字符串会被拒绝。
                      enum:
                        - 720p
                        - 1080p
                      example: 720p
                      default: 720p
                    duration:
                      type: integer
                      description: 数值整数 5 或 10 秒。仅在省略时默认为 5；字符串、布尔值、null 和小数会被拒绝。
                      enum:
                        - 5
                        - 10
                      example: 5
                      default: 5
                  additionalProperties: false
                callback_url:
                  type: string
                  nullable: true
                  description: 可选，接收任务完成通知的公开 HTTP(S) 地址，建议使用 HTTPS。省略、传 null 或传空字符串即不启用回调。
              description: >-
                model 和可选的 callback_url 放在根级。不支持的 input 字段会被拒绝。默认值仅对省略的字段生效；null
                和空的 input 值会被拒绝。
            examples:
              basic:
                summary: 夜间卧铺车窗
                value:
                  model: bytedance/seedance/v1/pro/text-to-video
                  input:
                    prompt: >-
                      One continuous cinematic five-second shot inside a Nordic
                      night sleeper-train compartment. An adult Nordic woman
                      with fair skin and a charcoal wool sweater sits in
                      three-quarter profile at the window, her hands resting on
                      her lap. Outside, a blizzard and dark conifer trunks
                      stream past. Begin as a medium shot of her quiet face and
                      the window, then slowly push in until the glass fills the
                      frame. Warm amber cabin lamps and cold blue snowlight must
                      stay physically consistent on the glass as layered
                      reflections. Keep her anatomy, sweater knit, and seat
                      geometry stable. No cuts, no other passengers, no readable
                      text, no logos, no brands, no advertising, no watermark.
                    resolution: 720p
                    duration: 5
              callback:
                summary: 夜间卧铺车窗（含完成回调）
                value:
                  model: bytedance/seedance/v1/pro/text-to-video
                  input:
                    prompt: >-
                      One continuous cinematic five-second shot inside a Nordic
                      night sleeper-train compartment. An adult Nordic woman
                      with fair skin and a charcoal wool sweater sits in
                      three-quarter profile at the window, her hands resting on
                      her lap. Outside, a blizzard and dark conifer trunks
                      stream past. Begin as a medium shot of her quiet face and
                      the window, then slowly push in until the glass fills the
                      frame. Warm amber cabin lamps and cold blue snowlight must
                      stay physically consistent on the glass as layered
                      reflections. Keep her anatomy, sweater knit, and seat
                      geometry stable. No cuts, no other passengers, no readable
                      text, no logos, no brands, no advertising, no watermark.
                    resolution: 720p
                    duration: 5
                  callback_url: https://your-domain.com/callback
      responses:
        '200':
          description: 任务已提交
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - data
                properties:
                  code:
                    type: integer
                    enum:
                      - 200
                  data:
                    type: object
                    required:
                      - task_id
                      - status
                      - created_time
                    properties:
                      task_id:
                        type: string
                      status:
                        type: string
                        enum:
                          - not_started
                          - running
                          - finished
                          - failed
                      created_time:
                        type: string
                        format: date-time
              example:
                code: 200
                data:
                  task_id: task-unified-example
                  status: running
                  created_time: '2026-09-10T08:00:00'
        '400':
          description: 输入无效、档位不支持、媒体无法访问或积分不足
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '401':
          description: 凭证无效
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '403':
          description: 拒绝访问
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '404':
          description: 模型未知或已停用
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '408':
          description: 请求超时
          content:
            text/plain:
              schema:
                type: string
              example: Request timeout
        '422':
          description: JSON 无效或请求体不是对象
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '429':
          description: 超出速率限制或 API Key 积分限额
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '500':
          description: 内部错误
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '502':
          description: 无法创建上游生成任务
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '503':
          description: 所请求的模型暂时不可用
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 使用 VIDGO_API_KEY。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.