suno-v4 API
Suno / Suno
通过 RunAPI 使用 Suno 系列的 suno-v4。按次计费,无需订阅,失败的生成不计费。
运行中
·
audio_music
·
可商用
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v4",
"prompt": "创作一首 2 分钟的 lo-fi 放松音乐,带有柔和钢琴、黑胶唱片质感和轻柔低音。"
}'
import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.textToMusic.run({
model: "suno-v4",
prompt: "创作一首 2 分钟的 lo-fi 放松音乐,带有柔和钢琴、黑胶唱片质感和轻柔低音。",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->textToMusic->run([
'model' => 'suno-v4',
'prompt' => '创作一首 2 分钟的 lo-fi 放松音乐,带有柔和钢琴、黑胶唱片质感和轻柔低音。',
]);
require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.text_to_music.run(
model: "suno-v4",
prompt: "创作一首 2 分钟的 lo-fi 放松音乐,带有柔和钢琴、黑胶唱片质感和轻柔低音。"
)
npx skills add runapi-ai/suno -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
切换变体
概览
suno-v4 在 Suno 家族中处于质量与成本的最佳平衡点。
- USD 按次定价
- 失败不计费
- 模型支持时流式
- Schema 校验后的工具调用
定价
定价
失败的生成不计费
Text to music
$0.12
/ track
Cover audio
$0.12
/ track
Extend music
$0.12
/ track
Create mashup
$0.12
/ track
规格
技术细节
| 模型 ID | suno-v4 |
| 提供方 | Suno |
| 模态 | audio_music |
| 任务类型 | asynchronous |
| 计费单位 | call |
| API 端点 | /api/v1/suno/text_to_music |
| 商用许可 | 允许商用 |
| 状态 | 运行中 |
技能
Model skill — suno-v4
安装一次 skill,开发时使用本页的变体 ID。
# Install the model skill for app development workflows
npx skills add runapi-ai/suno -g
Or use this setup request in your coding tool:
Install the Suno skill for this app: 1. Add runapi-ai/suno with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
工作流程
用 model skill 使用 suno-v4
01
安装
安装该模型线对应的 model skill。
02
配置
把 model 字段设置为本页展示的完整模型 ID。
03
调用
按 skill 说明把提示词、输入文件和回调处理接入应用。
04
接收
从 RunAPI 读取任务响应、webhook 回调或缓存输出 URL。
差异
suno-v4 与其它变体的差异
VS SUNO-V4.5
改进频率范围和连贯性,4 分钟上限
首次生成 8 分钟,流派错误减少 25%,人声自然度提升 40%
VS SUNO-V4.5-ALL
改进频率范围和连贯性,4 分钟上限
解锁全部 v4.5 风格和模式,无订阅限制
VS SUNO-V4.5-PLUS
改进频率范围和连贯性,4 分钟上限
v4.5 架构内的增强质量档位
应用场景
最适合的场景
播客与视频配乐
生成与节目氛围匹配的免版税背景音乐,无需授权费用。
游戏音频
为程序化生成的关卡生成自适应环境音效和配乐。
广告配音与音效
无需录音棚即可为客户广告生成定制配音和音效。
常见问题
suno-v4 常见问题
模型 ID 跨版本稳定吗?
RunAPI 保持模型 ID 稳定,并在不改变请求形态的前提下处理兼容版本刷新。
该变体的限流?
Key 级限流随使用层级伸缩。当前限制见定价页。
能切到其它变体吗?
可以——变体只是参数,改 model 字段即可。
支持流式吗?
模型支持流式时,RunAPI 端到端流式。
质量问题在哪里报?
在公共 GitHub 仓库提 issue 或邮件联系 support。
立即开始