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

> Turn a still image into a five- or ten-second video with Seedance 1.0 Pro, using text to guide the scene and motion.

<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 Image to Video

Turn a still image into a five- or ten-second video with Seedance 1.0 Pro, using text to guide the scene and motion.

## Available Models

* **bytedance/seedance/v1/pro/image-to-video** - Generate video from image input.

## 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 from image input.
* Accepts exactly 1 image in `image_urls`.
* 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.

### Image URLs

* `image_urls`: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL. Base64, a bare string instead of an array, and empty arrays are rejected.

### 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-image-to-video.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Seedance 1.0 Pro Image to Video
  description: >-
    Turn a still image into a five- or ten-second video with Seedance 1.0 Pro,
    using text to guide the scene and motion.
  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 Image 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_image_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/image-to-video
                  example: bytedance/seedance/v1/pro/image-to-video
                  description: >-
                    Vidgo public model ID. Must be
                    `bytedance/seedance/v1/pro/image-to-video`.
                input:
                  type: object
                  required:
                    - image_urls
                    - 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: >-
                        Animate this exact outdoor loom scene in one continuous
                        five-second shot. The same Ghanaian weaver throws the
                        wooden shuttle once through the open shed, then beats
                        the weft so the navy-and-gold cloth settles with a
                        slight sag. Preserve her face, hair, clothing, loom
                        geometry, textile pattern, mango-tree background, and
                        camera framing. Very slow gentle lateral camera drift.
                        Tactile wood and cloth physics. No extra people, no
                        cuts, no lettering, no logos, no brands, no advertising,
                        no watermark.
                      minLength: 1
                    image_urls:
                      type: array
                      items:
                        type: string
                        format: uri
                      maxItems: 1
                      description: >-
                        Exactly one HTTP(S) image URL with a hostname and no
                        embedded credentials or whitespace. Base64 and bare
                        strings are rejected.
                      example:
                        - >-
                          https://cdn.vidgo.ai/apis/models/bytedance/seedance/v1/pro/image-to-video/v1/01/input.png
                      minItems: 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: Kente Loom Shuttle
                value:
                  model: bytedance/seedance/v1/pro/image-to-video
                  input:
                    prompt: >-
                      Animate this exact outdoor loom scene in one continuous
                      five-second shot. The same Ghanaian weaver throws the
                      wooden shuttle once through the open shed, then beats the
                      weft so the navy-and-gold cloth settles with a slight sag.
                      Preserve her face, hair, clothing, loom geometry, textile
                      pattern, mango-tree background, and camera framing. Very
                      slow gentle lateral camera drift. Tactile wood and cloth
                      physics. No extra people, no cuts, no lettering, no logos,
                      no brands, no advertising, no watermark.
                    resolution: 720p
                    duration: 5
                    image_urls:
                      - >-
                        https://cdn.vidgo.ai/apis/models/bytedance/seedance/v1/pro/image-to-video/v1/01/input.png
              callback:
                summary: Kente Loom Shuttle with a completion callback
                value:
                  model: bytedance/seedance/v1/pro/image-to-video
                  input:
                    prompt: >-
                      Animate this exact outdoor loom scene in one continuous
                      five-second shot. The same Ghanaian weaver throws the
                      wooden shuttle once through the open shed, then beats the
                      weft so the navy-and-gold cloth settles with a slight sag.
                      Preserve her face, hair, clothing, loom geometry, textile
                      pattern, mango-tree background, and camera framing. Very
                      slow gentle lateral camera drift. Tactile wood and cloth
                      physics. No extra people, no cuts, no lettering, no logos,
                      no brands, no advertising, no watermark.
                    resolution: 720p
                    duration: 5
                    image_urls:
                      - >-
                        https://cdn.vidgo.ai/apis/models/bytedance/seedance/v1/pro/image-to-video/v1/01/input.png
                  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.

````