🎵音乐 API已上线

suno API

Suno 已通过 API in One 接入真实生产路由 /api/v1/audio/music，后端节点为 node7。一个 API Key 即可调用并按成功请求计费。

获取 API Key 查看文档

真实能力

以下能力来自当前已接入的模型配置和后端路由，不展示未上线 API。

稳定生产路由

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

统一接口

No separate Suno account or API key required

透明计费

Pay-as-you-go — no $22/mo minimum subscription

快速接入

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

任务状态

Webhook support for real-time completion notifications

请求方式

浏览器端只调用同源 API，服务端 BFF 再转发到对应 Worker。

方法端点积分用途

POST/api/v1/audio/music5-12 积分

Generate original music with lyrics or instrumental output.

POST/api/v1/audio/music/extend5-12 积分

Extend an existing completed track with new music.

GET/api/v1/audio/music/feed0 积分

Poll task status and retrieve completed audio results.

POST/api/v1/audio/music/cover/generate1 积分

Generate cover artwork for music tracks.

GET/api/v1/audio/music/cover/status0 积分

Check cover artwork generation status.

POST/api/v1/audio/music/upload-cover/generate8-12 积分

Upload audio and regenerate it as an AI cover.

GET/api/v1/audio/music/upload-cover/status0 积分

Check uploaded audio cover generation status.

POST/api/v1/audio/music/timestamped-lyrics2 积分

Return lyrics with word-level timestamps.

参数

promptstring

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

可选

gpt_description_promptstring

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

可选

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)

可选 · 默认 chirp-v3-5

stylestring

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

可选

titlestring

Track title. Max 80–100 chars.

可选

make_instrumentalboolean

Generate instrumental only (no vocals)

可选 · 默认 false

genderstring

Preferred vocal gender: "male" or "female"

可选

style_weightnumber

Style adherence strength (0–1)

可选

weirdness_constraintnumber

Creative deviation control (0–1)

可选

audio_weightnumber

Audio feature balance (0–1)

可选

callback_urlstring

Webhook URL for result notification

可选

示例请求

{
  "endpoint": "/api/v1/audio/music",
  "headers": {
    "Authorization": "Bearer <API_KEY>",
    "Content-Type": "application/json"
  },
  "body": {
    "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"
  }
}

任务状态查询

图像、视频、音频和工具任务创建后，使用真实任务端点查询结果。

GET/api/v1/tasks/{task_id}查询生成任务状态和结果。

价格

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

基础价格$0.10

积分10

计费按成功请求

使用场景

这些场景可通过当前模型和对应后端节点实现。

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

常见问题

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?

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