> ## 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.5 30s

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

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

## Model

| `model` | Billing | Duration |
| - | - | - |
| `seedance2.5-30s` | `per_task` | Fixed **30** seconds |

If you send `duration`, it must be `30`; otherwise it defaults to 30. First/last frame is not supported.

## Request body

| Field | Type | Required | Description |
| - | - | - | - |
| `model` | string | yes | `seedance2.5-30s` |
| `prompt` | string | yes | Max **5000** characters |
| `aspect_ratio` / `ratio` | string | no | `16:9` or `9:16` only; default `9:16` |
| `images` / `reference_images` | string\[] | no | Up to **30** images |
| `videos` / `reference_videos` | string\[] | no | Up to **10** videos |
| `audios` / `reference_audios` | string\[] | no | Up to **10** audios |

Use public `https://` URLs only.

## 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.5-30s",
    "prompt": "A cat running on grass, tracking shot",
    "aspect_ratio": "9:16",
    "images": ["https://example.com/cat.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.