LogoAPI in One
🎵

Suno API

active

Full-featured AI music generation platform. Supports text-to-music, extend tracks, upload audio covers, generate cover images, and timestamped lyrics. 7 API endpoints.

Suno AImusic10 credits/call
Provider
Suno AI
Pricing
1–12 credits per request (~$0.002–$0.024)
Speed
30–90 seconds
Output
audio

Quick Start

Send a request to the Suno API:

bash
curl -X POST https://apiin.one/api/v1/audio/music \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "chirp-v4-5",
  "prompt": "A cheerful pop song about summer days, with catchy melody and upbeat rhythm",
  "style": "pop, upbeat",
  "make_instrumental": false,
  "title": "Summer Days"
}'

API Endpoint

POST/api/v1/audio/music
Send a POST request with your API key to generate content using Suno.

Headers

HeaderTypeRequiredDescription
AuthorizationstringRequiredBearer YOUR_API_KEY
Content-TypestringRequiredapplication/json

Body Parameters

ParameterTypeRequiredDescription
modelstringRequiredModel identifier: "suno"
promptstringOptionalMusic description (inspiration mode) or lyrics (custom mode). Max 5000 chars.
gpt_description_promptstringOptionalText description for inspiration mode. Max 400 chars for v4.
modelstringOptionalModel: chirp-v4-0 (5cr), chirp-v4-5 (10cr), chirp-v4-5-plus (10cr), chirp-v5 (12cr) (Default: chirp-v3-5)
stylestringOptionalMusic style/genre (custom mode). Max 1000 chars.
titlestringOptionalTrack title. Max 80–100 chars.
make_instrumentalbooleanOptionalGenerate instrumental only (no vocals) (Default: false)
genderstringOptionalPreferred vocal gender: "male" or "female"
style_weightnumberOptionalStyle adherence strength (0–1)
weirdness_constraintnumberOptionalCreative deviation control (0–1)
audio_weightnumberOptionalAudio feature balance (0–1)
callback_urlstringOptionalWebhook URL for result notification

Available Endpoints

8 endpoints available for this model. All endpoints use the same API key.

POST/v2/generate生成原创音乐（支持歌词和纯音乐）5-12 cr
POST/v2/extend基于已有歌曲继续生成5-12 cr
GET/v2/feed轮询任务状态free
POST/v2/cover/generate为音乐生成封面图片1 cr
GET/v2/cover/status查询封面生成状态free
POST/v2/upload-cover/generate上传音频重新生成5-12 cr
GET/v2/upload-cover/status查询音频重新生成状态free
POST/v2/timestamped-lyrics获取带时间戳的歌词2 cr

Example Request

json
{
  "model": "chirp-v4-5",
  "prompt": "A cheerful pop song about summer days, with catchy melody and upbeat rhythm",
  "style": "pop, upbeat",
  "make_instrumental": false,
  "title": "Summer Days"
}

Example Response

Successful task creation response.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "gen2abc123def456bksv",
    "status": "IN_PROGRESS"
  }
}

Check Task Status

For asynchronous tasks, poll the status endpoint to check when your task is complete:

GET/api/v1/tasks/{task_id}
Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.
bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

Use Cases

  • ✓Generate original music from text prompts or custom lyrics
  • ✓Extend existing tracks with new content or different styles
  • ✓Upload audio files and create AI cover versions
  • ✓Generate album cover images for tracks
  • ✓Get word-level timestamped lyrics for karaoke/player UIs
  • ✓Build AI-powered music creation tools and apps

API Tester

Test the Suno API directly from your browser:

API PlaygroundPOST

Error Codes

{
  "error": {
    "code": 400,
    "message": "Invalid parameters",
    "type": "invalid_request"
  }
}

Frequently Asked Questions

How much does the Suno API cost?

Credits depend on model and endpoint: chirp-v4 = 5cr, chirp-v4.5 = 10cr, chirp-v5 = 12cr. Upload-cover = 8–12cr. Cover images = 1cr. Timestamped lyrics = 2cr.

What API endpoints are available?

7 endpoints: /v2/generate (create music), /v2/extend (extend tracks), /v2/feed (poll status), /v2/cover/generate+status (cover images), /v2/upload-cover/generate+status (audio covers), /v2/timestamped-lyrics (word-level lyrics).

Can I extend an existing song?

Yes. Use /v2/extend with a completed task ID. Supports inherit mode (seamless continuation) or custom mode (change style/lyrics).

Can I upload my own audio and create a cover?

Yes. Use /v2/upload-cover/generate to upload audio (max 8 min) and generate an AI cover with new vocals, style, and lyrics.

What model versions are available?

chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v4-5-all, and chirp-v5. Each version offers different quality tiers and pricing.

Do I need a separate Suno account?

No. API in One handles all provider authentication. You only need one API in One key.

Why Use Suno Through API in One?

1Full 7-endpoint API suite: generate, extend, feed, cover, upload-cover, lyrics
2No separate Suno account or API key required
3Pay-as-you-go — no $22/mo minimum subscription
4Multiple model versions (v4, v4.5, v4.5-plus, v4.5-all, v5)
5Webhook support for real-time completion notifications

Ready to use Suno?

Get Your API Key →