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

# Seedance 2.0 MD

> 统一视频创建入口。当前可用 model：seedance2.0-md、seedance2.5-30s。

Create a Seedance **2.0 MD** video via `POST /v1/videos` with `model` set to `seedance2.0-md`. Poll [Query video task](/en/api-reference/common/query) for `result.video_url`.

## Model

| `model` | Billing | Duration |
| - | - | - |
| `seedance2.0-md` | `per_task` | **5** / **10** / **15** seconds |

Output is fixed **720p**. `resolution` is ignored. First/last frame is not supported.

## Request body

| Field | Type | Required | Description |
| - | - | - | - |
| `model` | string | yes | `seedance2.0-md` |
| `prompt` | string | yes | Max **6000** characters |
| `duration` | int | yes | **5**, **10**, or **15**; default 5 |
| `aspect_ratio` / `ratio` | string | no | `1:1`, `3:4`, `4:3`, `9:16`, `16:9`, `21:9` |
| `images` / `reference_images` | string\[] | no | Up to **9** images |
| `videos` / `reference_videos` | string\[] | no | Up to **3** videos |
| `audios` / `reference_audios` | string\[] | no | Up to **3** audios |

Use public `https://` URLs only (no base64). GIF images are not supported.

## Example

```bash theme={null}
curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.0-md",
    "prompt": "Product turntable under studio lights",
    "duration": 5,
    "aspect_ratio": "1:1",
    "images": ["https://example.com/product.png"]
  }'
```


## OpenAPI

````yaml POST /v1/videos
openapi: 3.1.0
info:
  title: AI Platform OpenAPI
  description: >-
    Async image and video generation. Create a task, then poll task_id. Result
    URLs are kept about 3 days.
  version: 1.0.0
servers:
  - url: https://sigrunai.com
    description: AI Platform production
security:
  - bearerAuth: []
paths:
  /v1/videos:
    post:
      tags:
        - Videos
      summary: Create video task
      description: 'Unified video create. Available models: seedance2.0-md, seedance2.5-30s.'
      operationId: createVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoCreateRequest'
            examples:
              seedanceMd:
                summary: seedance2.0-md
                value:
                  model: seedance2.0-md
                  prompt: 城市夜景延时，车流光轨
                  duration: 10
                  aspect_ratio: '16:9'
              seedance30s:
                summary: seedance2.5-30s
                value:
                  model: seedance2.5-30s
                  prompt: 一只猫在草地上奔跑，跟拍镜头
                  aspect_ratio: '9:16'
      responses:
        '200':
          description: 提交成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskQueryResponse'
components:
  schemas:
    VideoCreateRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: seedance2.0-md 或 seedance2.5-30s
          example: seedance2.0-md
        prompt:
          type: string
        duration:
          oneOf:
            - type: integer
            - type: string
          description: seedance2.0-md：5/10/15；seedance2.5-30s：固定 30
        seconds:
          oneOf:
            - type: integer
            - type: string
          description: duration 别名
        aspect_ratio:
          type: string
        ratio:
          type: string
          description: aspect_ratio 别名
        orientation:
          type: string
          description: portrait/landscape 可推导比例
        size:
          type: string
        images:
          type: array
          items:
            type: string
            format: uri
        reference_images:
          type: array
          items:
            type: string
            format: uri
        videos:
          type: array
          items:
            type: string
            format: uri
        reference_videos:
          type: array
          items:
            type: string
            format: uri
        audios:
          type: array
          items:
            type: string
            format: uri
        reference_audios:
          type: array
          items:
            type: string
            format: uri
    TaskQueryResponse:
      type: object
      properties:
        code:
          type: integer
          example: 20000
        msg:
          type: string
        data:
          $ref: '#/components/schemas/TaskQueryData'
    TaskQueryData:
      type: object
      properties:
        task_id:
          type: string
        status:
          type: string
          description: queued / processing / completed / failed 等
        progress:
          type: integer
        model:
          type: string
        created_at:
          type: integer
        completed_at:
          type: integer
        cost:
          type: number
        error_message:
          type: string
        result:
          $ref: '#/components/schemas/TaskResult'
    TaskResult:
      type: object
      properties:
        image_url:
          type: string
        video_url:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'API key from the console. Format: Bearer sk_xxx'

````

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