suno/chirp-v3-5

文字轉音訊

Suno chirp-v3-5 API by SUNO

suno/chirp-v3-5

Chirp-v3-5

Suno text-to-music via APIMart: inspiration mode (custom=false) turns a description into a song; custom mode (custom=true) uses your own lyrics. Async; returns 2 tracks per generation.

輸入

提示詞

Custom

Instrumental

Vocal gender

Title

Style

Negative tags

進階設定

輸出

閒置

生成的音訊將顯示在這裡

輸入文字並點擊執行以合成語音。

參數

程式碼範例
import requests
import time

# Step 1: Start audio generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "suno/chirp-v3-5",  # Required. Model name. options: suno/chirp-v3-5
    "prompt": "Late-night city lo-fi piano with the sound of rain",  # With custom=false (default): an inspiration description of the song (style, mood, genre, theme)
    "custom": False,  # false = inspiration mode (prompt is a description)
    "instrumental": False,  # Instrumental only, no vocals
    "vocal_gender": "example_value",  # Vocal gender. options: Male | Female
    "title": "example_value",  # Song title
    "style": "example_value",  # Style tags, e
    "negative_tags": "example_value",  # Styles to avoid
    "auto_lyrics": False,  # Let the model rewrite the supplied lyrics creatively
    "style_weight": 0,  # How strongly to follow style. (min: 0, max: 1)
    "weirdness_constraint": 0,  # Creativity / weirdness. (min: 0, max: 1)
    "audio_weight": 0,  # Audio reference weight. (min: 0, max: 1)
    "persona_id": "example_value",  # Persona (voice identity) id
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated audio:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

audio_url = check_status()

安裝

安裝所需的相依套件。

pip install requests

驗證

所有 API 請求都需要透過 API Key 進行認證。您可以在 Atlas Cloud 控制台取得 API Key。

export ATLASCLOUD_API_KEY="your-api-key-here"

HTTP 標頭

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

保護好您的 API Key

切勿在客戶端程式碼或公開儲存庫中暴露您的 API Key。請使用環境變數或後端代理。

提交請求

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

提交請求

提交一個非同步生成請求。API 會傳回一個 prediction ID，您可以用它來檢查狀態與取得結果。

POST/api/v1/model/generateAudio

請求主體

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "suno/chirp-v3-5",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

回應

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

檢查狀態

輪詢 prediction 端點以檢查請求的當前狀態。

GET/api/v1/model/prediction/{prediction_id}

輪詢範例

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

狀態值

processing請求仍在處理中。

completed生成完成，輸出可用。

succeeded生成成功，輸出可用。

failed生成失敗，請檢查 error 欄位。

完成回應

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp3"
    ],
    "metrics": {
      "predict_time": 8.3
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Input Schema

以下參數在請求主體中被接受。

總計: 13必填: 1選填: 12

modelstringrequired

Model name.

Default: "suno/chirp-v3-5"

suno/chirp-v3-5

promptstring

With custom=false (default): an inspiration description of the song (style, mood, genre, theme). With custom=true: the actual lyrics, e.g. "[Verse]\n...\n[Chorus]\n...". Required unless custom=true and instrumental=true.

Default: "Late-night city lo-fi piano with the sound of rain"

customboolean

false = inspiration mode (prompt is a description). true = custom mode (prompt is used as lyrics, and title / style / negative_tags / auto_lyrics / persona_id / style_weight / weirdness_constraint / audio_weight take effect).

Default: false

instrumentalboolean

Instrumental only, no vocals.

Default: false

vocal_genderstring

Vocal gender. Takes effect in both modes.

MaleFemale

titlestring

Song title. Only takes effect when custom=true (ignored otherwise).

stylestring

Style tags, e.g. "synthwave, female vocal, cinematic". Only takes effect when custom=true (ignored otherwise).

negative_tagsstring

Styles to avoid. Only takes effect when custom=true.

auto_lyricsboolean

Let the model rewrite the supplied lyrics creatively. Only when custom=true.

Default: false

style_weightnumber

How strongly to follow style. Only when custom=true.

Min: 0Max: 1

weirdness_constraintnumber

Creativity / weirdness. Only when custom=true.

Min: 0Max: 1

audio_weightnumber

Audio reference weight. Only when custom=true.

Min: 0Max: 1

persona_idstring

Persona (voice identity) id. Only when custom=true.

範例請求主體

{
  "model": "suno/chirp-v3-5",
  "prompt": "Late-night city lo-fi piano with the sound of rain",
  "custom": false,
  "instrumental": false,
  "auto_lyrics": false
}

Output Schema

API 傳回包含生成輸出 URL 的 prediction 回應。

idstring

modelstring

statusstring

created|processing|completed|failed

outputsarray

Generated song URLs (2 tracks per generation).

thumbnailstring

Cover art generated alongside the song.

範例回應

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.png"
  ],
  "metrics": {
    "predict_time": 8.3
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills 將 400+ AI 模型直接整合到您的 AI 程式碼助手中。一條命令安裝，即可用自然語言生成圖片、影片，以及與 LLM 對話。

支援的客戶端

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ 支援的客戶端

安裝

npx skills add AtlasCloudAI/atlas-cloud-skills

設定 API Key

從 Atlas Cloud 控制台取得 API Key，並將其設定為環境變數。

export ATLASCLOUD_API_KEY="your-api-key-here"

功能

安裝完成後，您可以在 AI 助手中使用自然語言存取所有 Atlas Cloud 模型。

圖片生成使用 Nano Banana 2、Z-Image 等模型生成圖片。

影片創作使用 Kling、Vidu、Veo 等從文字或圖片創建影片。

LLM 對話與 Qwen、DeepSeek 及其他大型語言模型對話。

媒體上傳上傳本機檔案用於圖片編輯和圖生影片工作流程。

MCP Server

Atlas Cloud MCP Server 透過 Model Context Protocol 將您的 IDE 與 400+ AI 模型連接。支援任何相容 MCP 的客戶端。

支援的客戶端

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ 支援的客戶端

安裝

npx -y atlascloud-mcp

設定

將以下設定新增到您的 IDE 的 MCP 設定檔中。

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

atlas_generate_image根據文字提示生成圖片。

atlas_generate_video從文字或圖片創建影片。

atlas_chat與大型語言模型對話。

atlas_list_models瀏覽 400+ 可用 AI 模型。

atlas_quick_generate一步式內容創建，自動選擇最佳模型。

atlas_upload_media上傳本機檔案用於 API 工作流程。

了解更多

github.com/AtlasCloudAI/mcp-server

API Schema

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "The AtlasCloud API."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateAudio": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        },
        "x-api-name": "model_run"
      }
    },
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "description": "Request ID",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result of the request."
          }
        },
        "x-api-name": "model_result"
      }
    }
  },
  "components": {
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name.",
            "default": "suno/chirp-v3-5",
            "enum": [
              "suno/chirp-v3-5"
            ]
          },
          "prompt": {
            "type": "string",
            "description": "With custom=false (default): an inspiration description of the song (style, mood, genre, theme). With custom=true: the actual lyrics, e.g. \"[Verse]\\n...\\n[Chorus]\\n...\". Required unless custom=true and instrumental=true.",
            "default": "Late-night city lo-fi piano with the sound of rain",
            "x-ui-component": "textarea",
            "maxLength": 3000
          },
          "custom": {
            "type": "boolean",
            "description": "false = inspiration mode (prompt is a description). true = custom mode (prompt is used as lyrics, and title / style / negative_tags / auto_lyrics / persona_id / style_weight / weirdness_constraint / audio_weight take effect).",
            "default": false,
            "x-ui-component": "switch"
          },
          "instrumental": {
            "type": "boolean",
            "description": "Instrumental only, no vocals.",
            "default": false,
            "x-ui-component": "switch"
          },
          "vocal_gender": {
            "type": "string",
            "description": "Vocal gender. Takes effect in both modes.",
            "enum": [
              "Male",
              "Female"
            ]
          },
          "title": {
            "type": "string",
            "description": "Song title. Only takes effect when custom=true (ignored otherwise).",
            "maxLength": 200
          },
          "style": {
            "type": "string",
            "description": "Style tags, e.g. \"synthwave, female vocal, cinematic\". Only takes effect when custom=true (ignored otherwise).",
            "maxLength": 500
          },
          "negative_tags": {
            "type": "string",
            "description": "Styles to avoid. Only takes effect when custom=true.",
            "maxLength": 500
          },
          "auto_lyrics": {
            "type": "boolean",
            "description": "Let the model rewrite the supplied lyrics creatively. Only when custom=true.",
            "default": false,
            "x-ui-component": "switch"
          },
          "style_weight": {
            "type": "number",
            "description": "How strongly to follow style. Only when custom=true.",
            "minimum": 0,
            "maximum": 1
          },
          "weirdness_constraint": {
            "type": "number",
            "description": "Creativity / weirdness. Only when custom=true.",
            "minimum": 0,
            "maximum": 1
          },
          "audio_weight": {
            "type": "number",
            "description": "Audio reference weight. Only when custom=true.",
            "minimum": 0,
            "maximum": 1
          },
          "persona_id": {
            "type": "string",
            "description": "Persona (voice identity) id. Only when custom=true."
          }
        },
        "required": [
          "model"
        ],
        "x-order-properties": [
          "model",
          "prompt",
          "custom",
          "instrumental",
          "vocal_gender",
          "title",
          "style",
          "negative_tags",
          "auto_lyrics",
          "style_weight",
          "weirdness_constraint",
          "audio_weight",
          "persona_id"
        ]
      },
      "PredictionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "created|processing|completed|failed"
          },
          "outputs": {
            "type": "array",
            "description": "Generated song URLs (2 tracks per generation).",
            "items": {
              "type": "string",
              "x-format": "audio"
            }
          },
          "thumbnail": {
            "type": "string",
            "description": "Cover art generated alongside the song.",
            "x-format": "image"
          },
          "urls": {
            "type": "object"
          }
        }
      }
    }
  }
}

LLM 友善的提示詞範本

# suno/chirp-v3-5

> Suno text-to-music via APIMart: inspiration mode (custom=false) turns a description into a song; custom mode (custom=true) uses your own lyrics. Async; returns 2 tracks per generation.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateAudio` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `suno/chirp-v3-5`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  Model name.
  - Default: `"suno/chirp-v3-5"`
  - Options: "suno/chirp-v3-5"

- **`prompt`** (`string`, _optional_):
  With custom=false (default): an inspiration description of the song (style, mood, genre, theme). With custom=true: the actual lyrics, e.g. "[Verse]\n...\n[Chorus]\n...". Required unless custom=true and instrumental=true.
  - Default: `"Late-night city lo-fi piano with the sound of rain"`

- **`custom`** (`boolean`, _optional_):
  false = inspiration mode (prompt is a description). true = custom mode (prompt is used as lyrics, and title / style / negative_tags / auto_lyrics / persona_id / style_weight / weirdness_constraint / audio_weight take effect).
  - Default: `false`

- **`instrumental`** (`boolean`, _optional_):
  Instrumental only, no vocals.
  - Default: `false`

- **`vocal_gender`** (`string`, _optional_):
  Vocal gender. Takes effect in both modes.
  - Options: "Male", "Female"

- **`title`** (`string`, _optional_):
  Song title. Only takes effect when custom=true (ignored otherwise).

- **`style`** (`string`, _optional_):
  Style tags, e.g. "synthwave, female vocal, cinematic". Only takes effect when custom=true (ignored otherwise).

- **`negative_tags`** (`string`, _optional_):
  Styles to avoid. Only takes effect when custom=true.

- **`auto_lyrics`** (`boolean`, _optional_):
  Let the model rewrite the supplied lyrics creatively. Only when custom=true.
  - Default: `false`

- **`style_weight`** (`number`, _optional_):
  How strongly to follow style. Only when custom=true.
  - Min: 0
  - Max: 1

- **`weirdness_constraint`** (`number`, _optional_):
  Creativity / weirdness. Only when custom=true.
  - Min: 0
  - Max: 1

- **`audio_weight`** (`number`, _optional_):
  Audio reference weight. Only when custom=true.
  - Min: 0
  - Max: 1

- **`persona_id`** (`string`, _optional_):
  Persona (voice identity) id. Only when custom=true.



**Required Parameters Example**:

```json
{
  "model": "suno/chirp-v3-5"
}
```


**Full Example**:

```json
{
  "model": "suno/chirp-v3-5",
  "prompt": "Late-night city lo-fi piano with the sound of rain",
  "custom": false,
  "instrumental": false,
  "vocal_gender": "Male",
  "title": "",
  "style": "",
  "negative_tags": "",
  "auto_lyrics": false,
  "style_weight": 0,
  "weirdness_constraint": 0,
  "audio_weight": 0,
  "persona_id": ""
}
```


### Output Schema

The API returns the following output format:


- **`id`** (`string`, _optional_):

- **`model`** (`string`, _optional_):

- **`status`** (`string`, _optional_):
  created|processing|completed|failed

- **`outputs`** (`array[string]`, _optional_):
  Generated song URLs (2 tracks per generation).

- **`thumbnail`** (`string`, _optional_):
  Cover art generated alongside the song.

- **`urls`** (`object`, _optional_):



**Example Response**:

```json
{
  "id": "",
  "model": "",
  "status": "",
  "outputs": [
    ""
  ],
  "thumbnail": "",
  "urls": {}
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateAudio" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno/chirp-v3-5",
  "prompt": "Late-night city lo-fi piano with the sound of rain",
  "custom": false,
  "instrumental": false,
  "vocal_gender": "Male",
  "title": "",
  "style": "",
  "negative_tags": "",
  "auto_lyrics": false,
  "style_weight": 0,
  "weirdness_constraint": 0,
  "audio_weight": 0,
  "persona_id": ""
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/suno/chirp-v3-5)

Late-night city lo-fi piano with rain

[Verse] Neon streets on a rainy night [Chorus] Drive on, drive on

載入中...

Suno chirp-v3-5

Generate a full song — vocals or instrumental — from a text prompt, powered by Suno (version v3.5). Each generation returns 2 tracks plus cover art.

Two modes

mode	set	`prompt` means
Inspiration	`custom: false` (default)	a description of the song: style, mood, genre, theme
Custom	`custom: true`	the actual lyrics, e.g. `[Verse] ... [Chorus] ...`

In custom mode you can also set title, style, negative_tags, auto_lyrics, persona_id, style_weight, weirdness_constraint and audio_weight. Those fields are silently ignored in inspiration mode. vocal_gender and instrumental work in both.

Parameters

field	required	notes
`prompt`	yes	description (inspiration mode) or lyrics (custom mode), ≤3000 chars. Optional only when `custom: true` and `instrumental: true`
`custom`	no	`false` = inspiration (default), `true` = your own lyrics
`instrumental`	no	instrumental only, no vocals
`vocal_gender`	no	`Male` / `Female` — both modes
`title`	no	song title — custom mode only
`style`	no	style tags, e.g. `synthwave, female vocal, cinematic` — custom mode only
`negative_tags`	no	styles to avoid — custom mode only
`auto_lyrics`	no	let the model rewrite your lyrics — custom mode only
`style_weight`	no	0.00–1.00 — custom mode only
`weirdness_constraint`	no	0.00–1.00 — custom mode only
`audio_weight`	no	0.00–1.00 — custom mode only
`persona_id`	no	voice identity id — custom mode only

Output

outputs holds 2 audio URLs (two takes of the same request); the cover art is returned separately in thumbnail so it is never mixed into the audio list.

Notes

Async: submitting returns a request id; poll /api/v1/model/prediction/{request_id} until status is completed or failed. Generation typically takes 30–120s.
Billing: $0.12 per generation (both tracks included) — charged per request, not per track.

Example

Inspiration mode:

{
  "model": "suno/chirp-v3-5",
  "prompt": "Late-night city lo-fi piano with the sound of rain"
}

Custom mode with your own lyrics:

{
  "model": "suno/chirp-v3-5",
  "custom": true,
  "prompt": "[Verse]\nNeon streets on a rainy night\n[Chorus]\nDrive on, drive on",
  "title": "Midnight Drive",
  "style": "synthwave, female vocal, cinematic",
  "vocal_gender": "Female"
}

$0.132/次

NEW

文字轉音訊

Seed Audio 1.0

Doubao‑Audio‑Generate‑1.0 is Doubao Voice’s next‑generation audio‑generation engine. The industry‑first commercial tool creates film‑grade audio with just one prompt. It eliminates cumbersome audio‑engineering work. Creators generate publish‑ready radio dramas, podcasts and branded audio easily, shifting from a simple voice‑generator to an AI audio director. It serves audiobooks, serialized episodes and commercial audio for high‑quality narrative‑driven production.

xAI TTS v1

xAI TTS v1 is a high-fidelity text-to-speech model that converts text into natural, expressive speech with sub-second latency, supporting 20 languages and 80+ voices with fine-grained delivery control.

ElevenLabs v3 Text-to-Speech

ElevenLabs v3 Text-to-Speech model. High-quality speech generation from text prompts.

MiniMax Music 2.6

MiniMax text-to-music (latest): generate a full vocal or instrumental song from a style prompt plus lyrics with [Verse]/[Chorus] structure tags. Synchronous single-call generation.

Seed ASR 2.0

BytePlus Seed Speech recording-file recognition (ASR 2.0): transcribe an audio file to text with punctuation, ITN, sentence segmentation, speaker diarization, and 51-language support.

xAI STT v1

xAI STT v1 is a production-grade speech-to-text model that transcribes audio into accurate, formatted text. It supports 24+ languages with automatic language detection, word-level timestamps, speaker diarization, multichannel transcription, and inverse text normalization.

From

$0.002/分鐘

一個 API，暢享全模態 AI。

探索全部模型