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

# Mini Special Create Video

> 创建 Seedance 2.0 视频生成任务。支持满血版（sd2_mx_*，按秒计费，素材须审核）、SP 经济版（seedance2.0-sp / seedance2.0-fast-sp，按分辨率按秒计费）、SP 官方版（seedance2.0-of-sp / seedance2.0-of-fast-sp，按分辨率按秒计费）、Mini 版（seedance2.0-mini，按分辨率按秒计费）、Mini 特价版（seedance2.0-mini-sp，按次计费，仅 480p/720p）、MD（seedance2.0-md / seedance2.0-fast-md，按次计费，720p，不支持音频）、Fast I2V（seedance2.0-fast-i2v，按次计费，720p，仅图片参考最多 9 张，不支持参考视频/音频）、STD 标准版（seedance2.0-std，按次计费，720p，支持音频参考）。创建后使用 GET /api/open-api/v1/videos/{taskId} 查询结果。详见 seedance/md/create、seedance/md/fast-i2v、seedance/md/std、seedance/mini/create 与 seedance/mini-sp/create 文档。

Create a Seedance **2.0 Mini Special** video task (upstream: `aigc.cglol.com`). On success you receive a `task_id`. Poll [Query Video Task](/en/api-reference/common/query) until completed, then read the video URL from `result.video_url`.

<Note>
  This shares the same endpoint as other Seedance routes: `POST /api/open-api/v1/seedance/videos`. The `model` field selects the route.
</Note>

## Model

| Route        | Request `model`       | Billing model name                 | Billing      | Resolution      |
| ------------ | --------------------- | ---------------------------------- | ------------ | --------------- |
| Mini Special | `seedance2.0-mini-sp` | `seedance2.0-mini-sp-{resolution}` | **per-task** | `480p` / `720p` |

`{resolution}` only supports `480p` and `720p` (default), set via the `resolution` field.

## Billing

* **Per-task**: cost = unit price of the billing model in the console (e.g. `seedance2.0-mini-sp-720p`).
* `duration` is still required by the upstream (4–15 seconds, default 5) but does **not** affect billing.

## Request fields

| Field              | Type      | Required | Description                                                   |
| ------------------ | --------- | -------- | ------------------------------------------------------------- |
| `model`            | string    | Yes      | Must be `seedance2.0-mini-sp`                                 |
| `prompt`           | string    | Yes      | Text prompt                                                   |
| `duration`         | int       | Yes      | Seconds, 4–15 (default 5)                                     |
| `resolution`       | string    | No       | `480p` or `720p` (default)                                    |
| `ratio`            | string    | No       | Aspect ratio, e.g. `16:9`, `9:16`, `1:1`                      |
| `images`           | string\[] | No       | Reference images                                              |
| `first_image`      | string    | No       | First frame image                                             |
| `last_image`       | string    | No       | Last frame image                                              |
| `reference_videos` | string\[] | No       | Reference videos                                              |
| `reference_audios` | string\[] | No       | Reference audio; must be paired with images, video, or frames |

## Constraints

* `images` and `first_image` / `last_image` **cannot** be used together.
* `reference_audios` cannot be used alone; pair with images, reference video, or frames.

## Example

```bash theme={null}
curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.0-mini-sp",
    "prompt": "A model rotates to show clothing details.",
    "duration": 10,
    "resolution": "720p",
    "ratio": "9:16",
    "images": ["https://example.com/ref-1.jpg"]
  }'
```


## OpenAPI

````yaml POST /api/open-api/v1/seedance/videos
openapi: 3.1.0
info:
  title: Jimmy AI OpenAPI
  description: API for Jimmy AI video generation services
  version: 1.0.0
servers:
  - url: https://www.jimmyai.cn
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/open-api/v1/seedance/videos:
    post:
      summary: Create Seedance Video Task
      description: >-
        Create a Seedance 2.0 video task. Routes: Full/Manxue (sd2_mx_*,
        per-second, assets require audit), SP economy (seedance2.0-sp /
        seedance2.0-fast-sp, per-second by resolution), SP official
        (seedance2.0-of-sp / seedance2.0-of-fast-sp, per-second by resolution),
        Mini (seedance2.0-mini, per-second by resolution), Mini Special
        (seedance2.0-mini-sp, per-task, 480p/720p only), MD (seedance2.0-md /
        seedance2.0-fast-md, per-task, 720p, no audio), Fast I2V
        (seedance2.0-fast-i2v, per-task, 720p, image refs only, max 9, no
        reference video/audio), STD standard (seedance2.0-std, per-task, 720p,
        supports audio references). Poll GET /api/open-api/v1/videos/{taskId}
        for results. See seedance/md/create, seedance/md/fast-i2v,
        seedance/md/std, seedance/mini/create and seedance/mini-sp/create for
        details.
      operationId: createSeedanceVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SeedanceGenerationRequest'
      responses:
        '200':
          description: Task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
components:
  schemas:
    SeedanceGenerationRequest:
      type: object
      required:
        - model
        - prompt
        - duration
      properties:
        model:
          type: string
          description: >-
            Model name. Manxue: sd2_mx_720p | sd2_mx_1080p | sd2_mx_2k |
            sd2_mx_4k; Fast: sd2_mx_fast_720p | sd2_mx_fast_1080p; Video ref:
            sd2_mx_video_720p | sd2_mx_video_1080p | sd2_mx_video_2k |
            sd2_mx_video_4k; Video ref Fast: sd2_mx_video_fast_720p |
            sd2_mx_video_fast_1080p (all per-second). reference_videos only for
            video-series models. SP economy: seedance2.0-sp |
            seedance2.0-fast-sp (per-second by resolution). SP official:
            seedance2.0-of-sp | seedance2.0-of-fast-sp (per-second by
            resolution). Mini: seedance2.0-mini (per-second by resolution). Mini
            Special: seedance2.0-mini-sp (per-task, 480p/720p only). MD:
            seedance2.0-md | seedance2.0-fast-md (per-task, 720p). Fast I2V:
            seedance2.0-fast-i2v (per-task, 720p, image refs only). STD
            standard: seedance2.0-std (per-task, 720p)
        prompt:
          type: string
          description: 'Text prompt. MD route: max 5000 characters'
        duration:
          type: integer
          description: >-
            Duration in seconds. Full 4-12; SP economy 4-15; MD 1-15; STD
            standard 4-15. Default 5
        resolution:
          type: string
          enum:
            - 480p
            - 720p
            - 1080p
          description: Output resolution for SP economy. Default 720p
        orientation:
          type: string
          enum:
            - landscape
            - portrait
          description: Video orientation (ratio takes precedence if set)
        images:
          type: array
          items:
            type: string
          description: >-
            Reference images. Full route: asset://{assetId}; SP/MD/STD/Fast I2V:
            https:// URL. MD max 4; seedance2.0-fast-i2v and STD max 9. Mutually
            exclusive with first_image/last_image
        ratio:
          type: string
          description: >-
            Aspect ratio. MD: 16:9, 9:16, 1:1 only. STD: 21:9, 16:9, 4:3, 1:1,
            3:4, 9:16. Full route also supports 4:3, 3:4, 21:9, Adaptive
        first_image:
          type: string
          description: >-
            First frame. Full: asset://{assetId}; Economy/MD: https:// URL. MD
            frame mode requires last_image as well; first frame only is not
            supported
        last_image:
          type: string
          description: >-
            Last frame. Full: asset://{assetId}; Economy/MD: https:// URL. MD
            frame mode requires first_image as well
        reference_videos:
          type: array
          items:
            type: string
          description: >-
            Reference videos. Full: asset://{assetId}; Economy/MD: https:// URL.
            MD: max 3, combined duration ≤15s, combined size ≤200MB, each
            resolution 720px–2160px. Not supported on seedance2.0-fast-i2v
        reference_audios:
          type: array
          items:
            type: string
          description: >-
            Reference audio. Supported on Full, SP economy, and STD. Not
            supported on MD or seedance2.0-fast-i2v. Full: asset://{assetId};
            SP: https:// URL or asset://. STD max 3 clips; frame mode does not
            support audio references
    VideoGenerationResponse:
      type: object
      properties:
        code:
          type: string
          example: '20000'
        msg:
          type: string
          example: ok
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            model:
              type: string
            created_at:
              type: integer
              format: int64
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````