> ## 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 Text to Video

> Create five- or ten-second video scenes from written descriptions with Seedance 1.0 Pro, with output up to 1080p.

<Tip>
  1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`.
  2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails.
</Tip>

# Seedance 1.0 Pro Text to Video

Create five- or ten-second video scenes from written descriptions with Seedance 1.0 Pro, with output up to 1080p.

## Available Models

* **bytedance/seedance/v1/pro/text-to-video** - Generate video scenes from text prompts.

## Duration Options

* **5, 10 seconds** - Set `duration` as a numeric integer. Optional. Default: **5 seconds**, only when omitted. Strings, booleans, null and fractional values are rejected. A numeric value such as `5.0` is equivalent to `5`.

## Key Features

* Generate video scenes from text prompts.
* Choose from `720p`, `1080p` output resolutions.

## Advanced Parameters

Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`.

Send only the input fields supported by this workflow. Unsupported `input` fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials or whitespace. Defaults apply only when optional input fields are omitted; explicit null and empty values are rejected.

### Prompt

* `prompt`: Required string. Describe the scene and desired motion. After trimming surrounding whitespace, length must be **1-10,000 Unicode characters**. Non-string values are rejected.
* The value must not be blank when supplied.

### Resolution

* `resolution`: Optional. Accepted values: `720p`, `1080p`. Default: `720p`, only when omitted. Aliases, different casing, surrounding whitespace and numeric values are rejected.

## Pricing

Both workflows use the same price per generation (\$0.005 per credit):

| Resolution | Duration   | Credits | USD     |
| ---------- | ---------- | ------- | ------- |
| 720p       | 5 seconds  | 21      | \$0.105 |
| 720p       | 10 seconds | 42      | \$0.210 |
| 1080p      | 5 seconds  | 43      | \$0.215 |
| 1080p      | 10 seconds | 86      | \$0.430 |

Credits are deducted on submission and refunded if the task fails.


## OpenAPI

````yaml 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 Text to Video
  description: >-
    Create five- or ten-second video scenes from written descriptions with
    Seedance 1.0 Pro, with output up to 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 Text to Video
      description: >-
        Use the documented input types and values. Prompt must be a string
        containing 1–10,000 Unicode characters after trimming. Duration must be
        numeric 5 or 10; strings and fractional values are rejected. Resolution
        must be 720p or 1080p. Image input requires exactly one HTTP(S) URL with
        a hostname and no embedded credentials or whitespace; Base64 is not
        supported.
      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
                  enum:
                    - bytedance/seedance/v1/pro/text-to-video
                  example: bytedance/seedance/v1/pro/text-to-video
                  description: >-
                    Vidgo public model ID. Must be
                    `bytedance/seedance/v1/pro/text-to-video`.
                input:
                  type: object
                  required:
                    - prompt
                  description: Input parameters for generation
                  properties:
                    prompt:
                      type: string
                      description: >-
                        Required string; trim surrounding whitespace before
                        validating 1-10,000 Unicode characters.
                      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: >-
                        Only 720p or 1080p. Defaults to 720p only when omitted;
                        aliases, null and empty strings are rejected.
                      enum:
                        - 720p
                        - 1080p
                      example: 720p
                      default: 720p
                    duration:
                      type: integer
                      description: >-
                        Numeric integer 5 or 10 seconds. Defaults to 5 only when
                        omitted; strings, booleans, null and fractional values
                        are rejected.
                      enum:
                        - 5
                        - 10
                      example: 5
                      default: 5
                  additionalProperties: false
                callback_url:
                  type: string
                  nullable: true
                  description: >-
                    Optional public HTTP(S) endpoint for task completion
                    notifications. HTTPS is recommended. Omit, use null, or use
                    an empty string to disable callbacks.
              description: >-
                Keep model and optional callback_url at the root. Unsupported
                input fields are rejected. Defaults apply only to omitted
                fields; null and empty input values are rejected.
            examples:
              basic:
                summary: Night Sleeper Window
                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: Night Sleeper Window with a completion callback
                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: Task submitted
          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: >-
            Invalid input, unsupported tier, inaccessible media, or insufficient
            credits
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '401':
          description: Invalid credentials
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '404':
          description: Unknown or disabled model
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '408':
          description: Request timed out
          content:
            text/plain:
              schema:
                type: string
              example: Request timeout
        '422':
          description: Invalid JSON or non-object request body
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '429':
          description: Rate or API key credit limit exceeded
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '502':
          description: Unable to create the upstream generation task
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '503':
          description: Model configuration or capability is not approved
          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: Use VIDGO_API_KEY.

````