# suno/chirp-v3-0
> Suno text-to-music (chirp): generate a full song from a text prompt (and optional lyrics). Async; returns 2 variations.
## 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-0`
## 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-0"`
- Options: "suno/chirp-v3-0"
- **`prompt`** (`string`, _required_):
Describe the song: style, mood, genre, instrumentation, theme (and lyrics inline if desired). e.g. "upbeat indie pop about summer nights, female vocal".
- Default: `"upbeat indie pop about summer nights, bright female vocal, catchy chorus"`
- **`make_instrumental`** (`boolean`, _optional_):
Generate an instrumental track (no vocals).
- Default: `false`
**Required Parameters Example**:
```json
{
"model": "suno/chirp-v3-0",
"prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus"
}
```
**Full Example**:
```json
{
"model": "suno/chirp-v3-0",
"prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",
"make_instrumental": false
}
```
### 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 variations).
- **`urls`** (`object`, _optional_):
**Example Response**:
```json
{
"id": "",
"model": "",
"status": "",
"outputs": [
""
],
"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-0",
"prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",
"make_instrumental": false
}'
# 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-0)
