# Suno

> Songs with vocals and music from a description or your own lyrics. Two tracks per run, MP3.

Suno V6 is the main Suno model: natural vocals, rich arrangements and expressive music. Describe a song and the lyrics are written for you, or turn on «Own lyrics and style» to set the words, title, genre, voice and length (up to 6 minutes). Each run gives two different tracks in MP3. Price per run.

ID: `suno-v6` · $0.09 per run (2 MP3 tracks) · ~1.5 min

**Parameters** (field `input`). Settings other than prompt, custom_mode and instrumental apply when custom_mode=true.

| Field | Type | Values | Description |
|---|---|---|---|
| `version` | string | v6, v6-wild, v6-mini, v5.5, v5, v4.5-plus, v4.5-all, v4.5, v4 | Version: v6 (default), v6-wild, v6-mini, v5.5, v5, v4.5-plus, v4.5-all, v4.5, v4. Same price |
| `prompt` | string | up to 5000 chars | custom_mode=false: what the song is about (up to 3000 characters), lyrics are written for you. custom_mode=true: your lyrics (up to 5000), [Verse]/[Chorus] tags allowed |
| `custom_mode` | boolean | false | true — your own lyrics and the settings below (title required) |
| `instrumental` | boolean | false | true — no vocals |
| `title` | string | up to 80 chars | Title, up to 80 characters (custom_mode=true) |
| `style` | string | up to 1000 chars | Genre, instruments, mood, up to 1000 characters |
| `negative_tags` | string | up to 1000 chars | What to avoid in the sound |
| `vocal_gender` | string | auto, female, male | Voice: female, male or auto |
| `duration` | string | auto, 10…360 | Target length, 10–360 s or auto |
| `variety` | string | auto, off, normal, high, extra, max | Variety of the results |
| `style_weight` | string | auto, 0, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 1 | 0–1: how strictly to follow the style |
| `weirdness_constraint` | string | auto, 0, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 1 | 0–1: boldness |
| `audio_weight` | string | auto, 0, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 1 | 0–1: sound weight (not for instrumental) |

**Example: a song from a description**

```bash
curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"suno-v6","input":{"prompt":"A cheerful birthday song for mum Olga, pop, female vocal"}}'
```

```python
import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "suno-v6",
      "input": {
        "prompt": "A cheerful birthday song for mum Olga, pop, female vocal"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "suno-v6",
    "input": {
      "prompt": "A cheerful birthday song for mum Olga, pop, female vocal"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

**Example: your own lyrics**

```bash
curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"suno-v6","input":{"custom_mode":true,"title":"Summer evening","prompt":"[Verse]\nWarm wind, the sea is near\n[Chorus]\nSummer evening, you are here","style":"acoustic pop, guitar, warm","vocal_gender":"female","duration":"120"}}'
```

```python
import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "suno-v6",
      "input": {
        "custom_mode": True,
        "title": "Summer evening",
        "prompt": "[Verse]\nWarm wind, the sea is near\n[Chorus]\nSummer evening, you are here",
        "style": "acoustic pop, guitar, warm",
        "vocal_gender": "female",
        "duration": "120"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "suno-v6",
    "input": {
      "custom_mode": true,
      "title": "Summer evening",
      "prompt": "[Verse]\nWarm wind, the sea is near\n[Chorus]\nSummer evening, you are here",
      "style": "acoustic pop, guitar, warm",
      "vocal_gender": "female",
      "duration": "120"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

## Price

$0.09 per run — the answer always has two different tracks. Parameters (length, style, lyrics) do not change the price. A failure is refunded in full.

## Result

Same as any task: call [recordInfo](https://docs.mixmedia.tech/en/endpoints/record-info) or receive a [callback](https://docs.mixmedia.tech/en/callbacks). Links to the two MP3 tracks are in `resultJson.resultUrls` (kept for 24 hours).

## Error handling

API responses are JSON `{"code", "msg", "data"}`; errors also have a string `error` field (type). **On `/api/v1/*` the HTTP status matches body `code`.**

### Example response bodies

**400**

```json
{
  "code": 400,
  "msg": "input.duration: must be between 4 and 30, or \"auto\" / -1",
  "data": null,
  "error": "invalid_request_error"
}
```

**401**

```json
{
  "code": 401,
  "msg": "Authentication failed. Please check your API key",
  "data": null,
  "error": "authentication_error"
}
```

**402**

```json
{
  "code": 402,
  "msg": "Insufficient balance. Please top up and try again. Available: $0.01, required: $0.015. Top up at https://mixmedia.tech/cabinet/billing",
  "data": {
    "balance": "0.0100",
    "required": "0.0150",
    "currency": "USD",
    "topUpUrl": "https://mixmedia.tech/cabinet/billing"
  },
  "error": "payment_required"
}
```

**429**

```json
{
  "code": 429,
  "msg": "Rate limit exceeded: 10 createTask/upload requests per 10 s per key. Retry after 8s",
  "data": null,
  "error": "rate_limit_error"
}
```

**500**

```json
{
  "code": 500,
  "msg": "Internal server error",
  "data": null,
  "error": "server_error"
}
```

### Codes on createTask / upload

| code | error | Meaning | What to do |
|---|---|---|---|
| 400 | `invalid_request_error` | Invalid parameter or body | See `msg` |
| 400 | `unsupported_model` | Unknown model | [Model list](https://docs.mixmedia.tech/en/models) |
| 401 | `authentication_error` | Missing or invalid key | Check the key |
| 402 | `payment_required` | Not enough balance | Top up |
| 403 | `permission_error` | No access | Contact support |
| 429 | `rate_limit_error` | Too many requests | Wait for `Retry-After` |
| 505 | `model_disabled` | Model temporarily disabled | Pick another |
| 500 | `server_error` | Our failure | Retry later |

Example `msg` values: `Authentication failed. Please check your API key` (401); `Insufficient balance. Please top up and try again…` (402).

### Task errors (recordInfo)

If the task was created and then failed: `state: "fail"` (alias `status: "failed"`), `failCode` / `failMsg`, and `error: { code, message, type }`. Money is refunded (`refunded: true`).

| failCode | error.type | Meaning |
|---|---|---|
| 400 | `nsfw_content_detected` / `invalid_request_error` | Moderation — `failMsg` is upstream text verbatim |
| 422 | `invalid_request_error` | The model rejected the parameters (e.g. a photo could not be downloaded) |
| 501 | `server_error` | The model could not generate (`failMsg`) |
| 504 | `timeout_error` | Timed out — retry |
| 500 / 503 | `server_error` | Service temporarily unavailable |

### Rate limits

| What | Limit |
|---|---|
| createTask and upload | 20 per 10 s per key |
| recordInfo / list / balance | 100 per 10 s per key |

Over the limit — HTTP 429 and `Retry-After`.