从主题出发形成音乐草稿
没有现成歌词时，可用灵感模式描述歌曲主题、情绪和流派，例如温暖的生日歌曲或轻松的旅行配乐。它适合先把文字构想变成可试听素材，再判断音乐方向是否合适，减少在创作初期准备完整歌词的负担。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 型号定位
- Chirp v3.0／V3，旧版基础音乐生成
- 灵感创作
- custom=false，使用prompt描述主题与音乐方向
- 提示词范围
- 平台灵感模式：最多500字符
- 自定义创作
- custom=true，提交lyric、title与style
- 音乐形式
- 带人声歌曲；灵感模式可设置instrumental请求纯音乐
- 音频交付
- 入口音频格式选项为MP3，JSON结果包含audio_url与歌曲元数据
- 调用方式
- POST /suno/audios；model=chirp-v3-0；支持异步任务与回调
以上创作参数与交付方式属于本平台调用范围，不代表本型号具备新版的全部原生编辑能力。
核心能力
了解 chirp-v3-0 能为你的工作带来什么。
用已有歌词组织歌曲创作
已有歌词时，可切换到自定义模式，将歌词、标题和风格分别提交。歌词可以按主歌、副歌等段落组织，风格用于表达希望采用的音乐方向。这种工作流适合把文案草稿转成歌曲样稿，而不是逐音符编排或精确控制演唱。
将创作结果接入应用
生成结果以歌曲列表和元数据交付，应用可利用歌曲ID、标题、歌词、状态及音频地址建立试听页面。异步模式返回任务ID，便于将提交与结果展示分开处理；也可通过回调接收完成结果，不必让用户界面持续等待。
适用场景
从具体任务出发，找到模型发挥作用的位置。
音乐应用原型
为歌曲生成应用制作基础流程：用户输入主题，应用提交chirp-v3-0任务，随后展示状态和可播放音频。交付目标是验证主题输入、任务跟踪及试听体验是否顺畅，适合尚未涉及歌手身份复用或精细音轨编辑的原型。
主题歌曲样稿
将节日祝福、活动主题或故事歌词作为输入，结合希望采用的流派生成歌曲样稿。团队可围绕歌词与音乐的搭配进行试听讨论，再决定是否修改文字或更换创作方向。这里的交付物是讨论用音频，而非无需审核的最终成品。
背景音乐方向探索
在灵感模式中设置纯音乐选项，并描述画面情绪和音乐风格，为视频或展示内容探索配乐方向。先试听候选素材是否符合内容氛围，再进行剪辑和适配；如果任务要求严格卡点，应把时间编排放在后续音频制作环节完成。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
已有旧版项目时优先考虑
如果现有应用已经使用chirp-v3-0，或任务只需要基础歌曲草稿，它是延续既有调用方式的选择。chirp-v3-5是另一版本，不应直接当作相同入口。比较两者时，建议用同一主题和歌词试听，围绕实际成品选择，而不是预设固定的质量或速度差距。
需要更细控制时选择相关新版
若需求包含明确的男女声偏好，宜考虑chirp-v4-5及之后支持该控制的型号，chirp-v3-0不适合依赖vocal_gender的任务。对于复杂歌曲编辑，也应按所选版本的具体能力选择；不要因为共用音乐接口，就将新版的控制与编辑方式套用到旧版。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- chirp-v3-0面向基础生成，不适合作为全套音乐编辑工具使用。Persona、片段替换、多轨分离等属于需要分别判断适用性的工作流，不能因为请求中存在相关选项，就期待旧版完成所有操作。
- 风格描述和歌词段落用于引导创作，不等于精确的演唱时间表。需要固定镜头卡点、逐字对齐或严格成品长度时，应试听生成音频并进行后期处理，实际时长以完成结果中的duration为准。
- 结果中的音频、图片和视频是不同资产字段，不能把字段存在理解为每项都会生成可用文件。应用应检查success、歌曲state与实际audio_url，完成后保存所需音频，避免将未完成任务直接展示为可播放成品。
常见问题
解答使用 chirp-v3-0 时的常见疑问。
chirp-v3-0和chirp-v3-5是同一个型号吗？
不是。chirp-v3-0对应旧版V3创作选项，chirp-v3-5是另一个版本，调用时应分别指定准确的model值。已有项目可继续围绕原型号组织流程；要换版本，建议使用相同主题和歌词比较实际试听结果。
没有歌词可以使用chirp-v3-0吗？
可以使用灵感模式，将custom设为false，在prompt中描述主题、情绪和音乐方向，平台该模式最多接受500字符。如果已经有需要采用的歌词，则改用自定义模式，将歌词与标题、风格分别提交。
chirp-v3-0能生成纯音乐吗？
可在灵感模式中通过instrumental请求纯音乐，并用prompt说明希望呈现的流派和情绪。该方式适合探索背景配乐方向；生成后仍需试听，确认音频内容是否符合用途，再进行剪辑与时长适配。
能用vocal_gender指定男声或女声吗？
不要依赖该参数控制chirp-v3-0。vocal_gender的有效范围是4.5及以上型号，并且属于偏好控制而非严格保证。如果男女声偏好是任务的重要条件，应选择支持这一控制的相关型号。
提交后怎样取得chirp-v3-0的音频？
向/suno/audios提交生成请求并指定model。设置async=true时可先取得task_id，再跟踪任务，也可设置callback_url接收结果。完成后从data中的audio_url获取音频，同时检查歌曲状态，不要只凭任务ID判断生成成功。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Pricing
$0.0447· per generation
Top-up
You pay$71,316for 750,000 credits · $0.0951 / credits46% OFF
You're billed in credits. Pick a top-up tier to see its per-credit rate — the larger the top-up, the cheaper each credit.
Quickstart
Try the API
API Key
Please obtain an API Key first
This is only a basic call example. See the full docs for more parameters and advanced usage.
View Docs