---
title: "Generate V3"
method: POST
path: "/v1/generations/v3"
---

# Generate V3

`POST /v1/generations/v3`

## Request

- Base URL: `https://api.sonauto.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sonauto.ai/v1/generations/v3`
- Auth: none declared

## Query parameters

- `credits_check` boolean

## Headers

- `authorization` string

## Request body

- PubAPIV3GenerateRequest
  - `webhook_url` string, nullable
  - `output_format` 'flac' | 'mp3' | 'wav' | 'ogg' | 'm4a'
  - `output_bit_rate` 128 | 192 | 256 | 320, nullable
  - `align_lyrics` boolean
  - `enable_streaming` boolean
  - `lyrics_model` 0 | 1 | 2 | 3, nullable
  - `length_range` unknown[], nullable
    - unknown
  - `tags` string[]
  - `lyrics` string
  - `prompt` string, nullable
  - `instrumental` boolean
  - `prompt_strength` number
  - `style_scale` number
  - `negative_tags` string[]
  - `stream_format` 'mp3' | 'ogg'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-27** `ad0a5ad70672`: 2 info
  - added the new `2.00` enum value to the request property `lyrics_model/anyOf[subschema #1]/`
  - added the new `3.00` enum value to the request property `lyrics_model/anyOf[subschema #1]/`
- **2026-10-04** `00dfc5f16f7c`: 1 info
  - added the new optional request property `lyrics_model`
- **2026-10-03** `f2ad460c4b70`: 1 info
  - the `style_scale` request property default value changed from `4.5` to `2.3`

[Operation history](https://skmtc.dev/sonauto/apis/sonauto-api/changes/v1/generations/v3/post.md)

---

[API](https://skmtc.dev/sonauto/apis/sonauto-api.md) - [All operations](https://skmtc.dev/sonauto/apis/sonauto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sonauto/apis/sonauto-api/revisions/c5755807c38a?raw)