> ## 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.

# Generate Standalone Video

> Standalone Suno video generation from a text prompt

Submit a standalone video generation job. Poll [Get Task Status](/api-reference/suno/task) until `success`.

## Parameters

| Field                | Type   | Required | Description                 |
| -------------------- | ------ | -------- | --------------------------- |
| `prompt`             | string | Yes      | Video prompt                |
| `video_gen_category` | enum   | Yes      | `basic` or `advanced`       |
| `duration`           | number | Yes      | Length in seconds, **5–30** |

## Credits

Billing is **per second** (category × duration). Per the OpenAPI spec:

| `video_gen_category` | Rate               |
| -------------------- | ------------------ |
| `basic`              | 2 credits / second |
| `advanced`           | 4 credits / second |

Examples: `basic` + 5s → 10 credits; `advanced` + 10s → 40 credits.

<Info>
  Deployment policy may also be expressed as `conf_task_policy[standalone_video_generate].cost × duration` (e.g. cost=20 → 100 credits for 5 seconds).
</Info>

## Result

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

## Example

<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 Poll 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

````