把主题描述变成音乐草案
灵感模式适合尚未写好歌词的创作起点。用简短文字说明歌曲主题、流派和情绪，设置 custom=false，再通过 prompt 发起生成；需要背景配乐时可选择 instrumental。它让创作从文字意图开始，而不必先准备乐器录音。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作方式
- 灵感模式与自定义歌词模式
- 音乐类型
- 带人声歌曲、纯音乐
- 灵感提示词
- 平台输入上限500字符
- 自定义歌词
- 平台输入上限3000字符
- 风格与标题
- 平台上限：style 200字符、title 80字符
- 歌曲时长档位
- 平台V4型号上限150秒；实际时长以结果为准
- 音频交付
- MP3音频地址及歌曲元数据，支持异步任务与回调
上述数字为本平台的 V4 使用规格，创作参数与成品表现应按对应型号和操作区分。
核心能力
了解 chirp-v4 能为你的工作带来什么。
让已有歌词进入试唱
自定义模式适合已有主歌、副歌或活动文案的项目。设置 custom=true，提交 lyric、title 和 style，把歌词内容与音乐方向分开表达。V4 的风格空间较紧凑，宜优先写核心流派、主要乐器与情绪，避免用冗长描述挤占输入。
交付音频，也保留创作信息
生成结果以音频地址为核心，同时可携带歌曲ID、标题、歌词、状态和实际时长，便于应用建立试听与归档流程。需要后台处理时，可用 async=true 获取 task_id，或配置 callback_url 接收结果，让音乐任务与前台交互分开。
适用场景
从具体任务出发，找到模型发挥作用的位置。
活动主题歌初稿
输入活动主题、受众和希望传达的情绪，先用灵感模式制作可试听草案；有确定口号或副歌时，再改用自定义歌词。交付音频与对应文本，供策划团队讨论音乐方向。品牌名、关键口号和演唱内容应在试听后逐项确认。
歌词写作与旋律试唱
把已写好的歌词按主歌、副歌等段落组织，配上简短风格说明，生成用于讨论的演唱版本。适合检查文字进入音乐后的节奏感、段落长度与情绪走向。成品可作为修改歌词的参考，而不是把返回的歌词字段当作音频逐字转写。
短视频配乐方向探索
围绕视频画面描述轻快、舒缓或紧张等音乐情绪，选择纯音乐，制作候选配乐用于粗剪试听。保存音频及其实际时长，再在剪辑工具中匹配画面节点。适合探索配乐方向，但精确卡点、固定秒数和最终剪辑仍需后期完成。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
短篇创作与旧项目继续使用V4
如果现有应用已经围绕 chirp-v4 的歌词与风格限制组织输入，或任务主要是短篇歌曲和音乐草案，可以继续选择 V4。与 V3.5 的120秒档位相比，V4 的150秒档位提供更长的篇幅；这个差别用于规划内容长度，不代表每次都生成到上限，也不构成音质或速度比较。
长歌词与人声偏好选择V4.5
当歌词超过3000字符、风格描述需要更大空间，或需要男女声偏好控制时，更适合选择 chirp-v4-5。V4.5 的歌词与风格上限分别为5000和1000字符，时长档位为4分钟。不要只给V4加入新版参数来替代换型；共享接口中的字段不意味着各版本效果相同。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- V4 更适合紧凑的歌词与风格描述：自定义歌词、风格和标题分别受3000、200和80字符限制。长篇歌词应先精简或选择其他版本；灵感模式则使用500字符以内的 prompt，不应把整首歌词直接塞进主题提示词。
- 时长控制不是精确剪辑。平台列出的 V4 最长时长为150秒，不表示每首作品都会达到该长度。自定义生成（custom=true、action=generate）可提交 duration 作为期望时长提示，但该提示可能被忽略，不保证达到目标。需要严格的片头、广告或镜头卡点时，应根据返回的实际时长试听，再通过剪辑完成最终交付。
- V4 不提供V4.5起适用的 vocal_gender 偏好控制，也不能默认具备其他版本的全部编辑能力。歌词与风格主要用于引导生成，重要文字是否被正确演唱仍需听音确认；发布使用前还应核实歌词和参考素材的使用权。
常见问题
解答使用 chirp-v4 时的常见疑问。
chirp-v4 怎样从一句描述开始生成？
向 POST /suno/audios 提交 model=chirp-v4、action=generate 和 custom=false，在 prompt 中描述主题与音乐方向，长度不超过500字符。若希望制作不含演唱的配乐，可设置 instrumental=true，再取得完成后的音频结果。
已有歌词应该使用哪种模式？
使用 custom=true，把歌词放入 lyric，标题放入 title，音乐方向放入 style。V4 对这三项的上限分别是3000、80和200字符。建议分清歌词内容与风格说明，保留清晰段落，方便生成后逐段试听和修改。
能让V4固定生成指定长度吗？
不能把期望时长当作精确保证。平台列出的 V4 最长时长为150秒，实际作品可能更短。自定义生成（custom=true、action=generate）可提交 duration 作为期望时长提示，但它可能被忽略，也不保证达到目标长度。应读取结果中的 duration 并试听，固定秒数的交付可在生成后进行裁剪。
V4可以指定男声或女声吗？
不要依赖 vocal_gender 在V4上实现这项控制，该参数从V4.5开始适用。若男女声偏好是选型的重要条件，应选择 chirp-v4-5 或适用的后续型号；即使在支持的型号中，它也是偏好引导，而不是严格遵循的保证。
异步生成后如何取得歌曲？
设置 async=true 后，先保存返回的 task_id，再通过任务查询取得状态与结果；也可配置 callback_url 接收完成通知。歌曲完成后读取 data 中的 audio_url、id 和 duration，下载音频并保存元数据，便于后续试听和归档。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits
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
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.