🎵Music APIActive

suno API

Full Suno API suite via API in One. Generate music, extend tracks, upload audio covers, create cover images, get timestamped lyrics. 8 endpoints, pay-as-you-go from 5 credits.

Real routes8Real endpoint rows linked to this model.

Endpoint models2Live models sharing this endpoint.

Base cost10 credits$0.10 · 30–90 seconds

Endpoint familyMusic API/api/v1/audio/music

Get API Key View Docs

Model IDsuno

Use this in the request body model field.

Endpoint/api/v1/audio/music

The currently implemented BFF route.

Outputaudio

Input types: text

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookSupported

Use callback_url on supported async tasks.

Service highlights

Marketplace-style signals backed by the current live route, without copying external SLA, discount, login, or payment claims.

Live production route

This page only shows endpoints implemented under /api/v1. /api/v1/audio/music

Webhook / polling

Use callback_url when supported, or poll the task status route for results.

Shared billing system

Top-up, orders, credit balance, and profile continue through the existing shared console.

Managed provider credentials

Your browser only holds an API in One key; provider calls stay server-side.

Call contract

Use these fields to integrate the current live model route.

Base URL: https://apiin.one
Authorization: Authorization: Bearer <API_KEY>
Model field: suno
Result path: /api/v1/tasks/{task_id}
Billing path: /billing/credits

Runtime behavior

This model creates an async task, returns a task_id, then resolves through the real status route.

Client request/api/v1/audio/musictask_id -> result

View usage logs

API Console

Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.

Live model2 live models

Endpoint8 Routes

ProviderSuno AIhttps://n7.gogloai.com

Current cost10 credits · $0.101–12 credits per request (~$0.01–$0.12)

RuntimeAsync taskAsync jobs return task_id, then use status polling.

Input / outputtext -> audioUse callback_url when supported, or poll the task status route for results.

Backend nodenode7Your browser only holds an API in One key; provider calls stay server-side.

Request previewPOST /api/v1/audio/music

curl --request POST \
  --url https://apiin.one/api/v1/audio/music \
  --header 'Authorization: Bearer <API_KEY>'
  --header 'Content-Type: application/json' \
  --data-raw '{
  "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"
}'

Result path/api/v1/tasks/{task_id}

Open docs

Endpoint decision panel

Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.

Endpoint models2These models share the same BFF route and switch through the model field.

Provider coverage2Real provider sources currently exposed by this endpoint.

Cost range10-30 credits$0.10-$0.30 · Based on the current live catalog base credit cost.

Webhook coverage1/2Models on this endpoint that support callback_url.

Current model position1/2

Sorted by base credits from low to high.

Lowest-cost route in this endpointsuno

Suno AI · 10 credits · $0.10

Production patternAsync task + webhook/polling

Use callback_url when supported, or poll the task status route for results.

Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

Full 8

Full 8-endpoint API suite: generate, extend, feed, cover, upload-cover, lyrics

Use the same API in One key as the rest of the routed catalog

Credit

Credit-based billing through the shared billing console

Multiple model versions (v4

Multiple model versions (v4, v4.5, v4.5-plus, v4.5-all, v5)

Webhook support for real

Webhook support for real-time completion notifications

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/audio/music5-12 credits

Generate original music with lyrics or instrumental output.

POST/api/v1/audio/music/extend5-12 credits

Extend an existing completed track with new music.

GET/api/v1/audio/music/feed0 credits

Poll task status and retrieve completed audio results.

POST/api/v1/audio/music/cover/generate1 credits

Generate cover artwork for music tracks.

GET/api/v1/audio/music/cover/status0 credits

Check cover artwork generation status.

POST/api/v1/audio/music/upload-cover/generate8-12 credits

Upload audio and regenerate it as an AI cover.

GET/api/v1/audio/music/upload-cover/status0 credits

Check uploaded audio cover generation status.

POST/api/v1/audio/music/timestamped-lyrics2 credits

Return lyrics with word-level timestamps.

Parameters

promptstring

Music description (inspiration mode) or lyrics (custom mode). Max 5000 chars.

Optional

gpt_description_promptstring

Text description for inspiration mode. Max 400 chars for v4.

Optional

modelstring

Model: chirp-v3-5 (5cr), chirp-v4-0 (8cr), chirp-v4-5 (10cr), chirp-v4-5-plus (10cr), chirp-v5/chirp-v5-5 (12cr)

Optional · Default chirp-v3-5

stylestring

Music style/genre (custom mode). Max 1000 chars.

Optional

titlestring

Track title. Max 80–100 chars.

Optional

make_instrumentalboolean

Generate instrumental only (no vocals)

Optional · Default false

genderstring

Preferred vocal gender: "male" or "female"

Optional

style_weightnumber

Style adherence strength (0–1)

Optional

weirdness_constraintnumber

Creative deviation control (0–1)

Optional

audio_weightnumber

Audio feature balance (0–1)

Optional

callback_urlstring

Webhook URL for result notification

Optional

Example request

curl -X POST https://apiin.one/api/v1/audio/music \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "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"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

🎶minimax-musicaudio · 30 credits/api/v1/audio/music

Endpoint model comparison

Compare real models behind this implemented route by cost, provider, runtime mode, input, output, and backend node.

/api/v1/audio/music2 live models

ModelProviderRoute modeInput / outputBase costBackend node

🎵sunoCurrent modelSuno AIAsync tasktext -> audio10 credits$0.10node7🎶minimax-musicMiniMaxAsync tasktext -> audio30 credits$0.30node74

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/audio/music

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

1–12 credits per request (~$0.01–$0.12)

Base cost$0.10

Credits10

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

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

FAQ

How much does the Suno API cost?

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

What API endpoints are available?

8 endpoints: /api/v1/audio/music (create music), /api/v1/audio/music/extend, /api/v1/audio/music/feed, cover generate/status, upload-cover generate/status, and timestamped lyrics.

Can I extend an existing song?

Yes. Use /api/v1/audio/music/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 /api/v1/audio/music/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-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5, and chirp-v5-5. Each version offers different quality tiers and pricing.

Do I need a separate Suno account?

Use the API in One key shown in your dashboard for this routed Suno API workflow.

suno API

Service highlights

Call contract

Runtime behavior

API Console

Endpoint decision panel

Live capabilities

Full 8

Use the same API in One key as the rest of the routed catalog

Credit

Multiple model versions (v4

Webhook support for real

Request format

Parameters

Example request

Models on the same endpoint

Endpoint model comparison

Integration flow

Create a shared API key

Call the real endpoint

Poll task status

Task status route

Pricing

Use cases

FAQ

Related live models