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

# 独立视频生成

> 根据文本提示词独立生成 Suno 视频

提交独立视频生成任务，通过 [查询任务状态](/zh/api-reference/suno/task) 轮询至 `success`。

## 参数

| 字段                   | 类型     | 必填 | 说明                   |
| -------------------- | ------ | -- | -------------------- |
| `prompt`             | string | 是  | 视频提示词                |
| `video_gen_category` | enum   | 是  | `basic` 或 `advanced` |
| `duration`           | number | 是  | 时长（秒），**5\~30**      |

## 积分

按**秒**计费（类别 × 时长）。OpenAPI 说明：

| `video_gen_category` | 费率     |
| -------------------- | ------ |
| `basic`              | 2 积分/秒 |
| `advanced`           | 4 积分/秒 |

示例：`basic` + 5 秒 → 10 积分；`advanced` + 10 秒 → 40 积分。

<Info>
  部署策略也可能表示为 `conf_task_policy[standalone_video_generate].cost × duration`（例如 cost=20 时，5 秒消耗 100 积分）。
</Info>

## 结果

```json theme={null}
{
  "batch_id": "xxx",
  "items": [
    { "status": "complete", "video_url": "https://..." },
    { "status": "complete", "video_url": "https://..." }
  ]
}
```

## 示例

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.mountsea.ai/suno/v2/video/standalone/generate \
    -H "Authorization: Bearer your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "waves crashing on a beach",
      "video_gen_category": "basic",
      "duration": 5
    }'
  ```

  ```bash 轮询 theme={null}
  curl "https://api.mountsea.ai/suno/v2/status?taskId=YOUR_TASK_ID" \
    -H "Authorization: Bearer your-api-key"
  ```
</CodeGroup>


## OpenAPI

````yaml POST /suno/v2/video/standalone/generate
openapi: 3.0.0
info:
  title: Suno AI
  description: API documentation for Suno AI
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: suno
    description: ''
  - name: suno/studio
    description: Studio Song Editor（与 audio/crop|fade|reverse 独立）
paths:
  /suno/v2/video/standalone/generate:
    post:
      tags:
        - suno
      summary: generate standalone video
      description: >-
        Submit a standalone video generation task. Returns taskId to poll via
        /status.

        Credit deduction is parameter-based (category × duration × quantity).
          - video_gen_category=basic  → 2 credits/sec
          - video_gen_category=advanced → 4 credits/sec
      operationId: ApiPublicController_generateStandaloneVideo
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateStandaloneVideoDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
      security:
        - bearerAuth: []
components:
  schemas:
    GenerateStandaloneVideoDto:
      type: object
      properties:
        prompt:
          type: string
          description: 视频生成提示词
        video_gen_category:
          enum:
            - basic
            - advanced
          type: string
          description: >-
            basic /
            advanced（当前积分规则相同，均按秒计：conf_task_policy[standalone_video_generate].cost
            × duration）
          default: basic
        duration:
          type: number
          minimum: 5
          maximum: 30
          description: 视频时长（秒）
          default: 5
      required:
        - prompt
        - video_gen_category
        - duration
    TaskIdDto:
      type: object
      properties:
        taskId:
          type: string
          description: task id. Use this id to query task status.
          example: 15c257ff-43f7-4678-bd41-202ad6b8488b
      required:
        - taskId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````