4Z API

创建音乐

接口: POST https://4zapi.com/suno/submit/music

等价于 POST /suno/submit/{action} 且 action=music（路由参数见 manifest）。

支持模型（mv）：用户侧可复制 ID（与下方 examples 对齐；chirp-auk / chirp-fenix 仅为别名）：

  • chirp-v3-0（对应版本 v3.0）
  • chirp-v3-5（对应版本 v3.5）
  • chirp-v4（对应版本 v4.0）
  • chirp-v4-5（对应版本 v4.5；别名 chirp-auk）
  • chirp-v5（对应版本 v5.0）
  • chirp-v5-5（对应版本 v5.5；别名 chirp-fenix）
  • chirp-v6（对应版本 v6.0）
  • chirp-v6-wild（对应版本 v6-wild）
  • chirp-v6-mini（对应版本 v6-mini）

字段优先级：若同时提供 gpt_description_prompt 与 prompt，以网关/上游实际分支为准（勿当作简单二选一可同时填）。详见 API-Doc-Standards §2.3。

clip 续写：continue_clip_id 须来自先前 fetch 返回的 clip/song，不可自造。

接入步骤

A. 生成音乐

可以通过场生成歌曲接口生成后，获取其中的一首歌的 clip_id 值为： 54834687-5e79-4f08-8e14-cf188f15b598

B. 新建 Persona

  • clip_id 需要系统内存在的，非 uploader
  • 不能跨账号，所以可能账号下线用不了

C. 使用 persona_id 创作

注意事项：

  • mv 为 chirp-v3-5-tau 或者 chirp-v4-tau
  • task 为 artist_consistency
  • persona_id 为 B 步骤得到的
  • artist_clip_id 就是 A 步骤中的 clip_id
  • 可跨账号

提交 AI 音乐创作任务，支持三种模式：

  • 描述模式：填写 gpt_description_prompt，AI 自动生成音乐风格与歌词
  • 自定义模式：填写 prompt（歌词）+ tags（风格标签），精确控制创作方向
  • 纯音乐模式：设置 make_instrumental: true，生成无歌词背景音乐
  • 续写模式：填写 continue_clip_id + continue_at，延续已有片段

请求体 (application/json)

  • artist_clip_id (string): 源曲 clip_id（步骤 A 生成音乐后从 fetch 结果取得）。task=artist_consistency 时必填，且应与创建 Persona 时使用的 root_clip_id 为同一首源曲。须为系统内已生成 clip，非 uploader 临时 ID。
  • continue_at (number): 从源音频第几秒开始续写（配合 continue_clip_id）
  • continue_clip_id (string): 续写/补段用的源 clip ID。须为已生成歌曲的 clip_id（从 GET /suno/fetch/:id 结果获取），非 task_id
  • gpt_description_prompt (string): 灵感模式：用自然语言描述想要的音乐风格/主题（与 prompt 二选一，优先灵感）
  • make_instrumental (boolean): 是否生成纯音乐（无人声）
  • metadata (object): 扩展字段；可通过 metadata.task 或 metadata.metadata_params 传参（与顶层二选一即可）
  • metadata_params (object): Open 渠道扩展参数，按 task 传不同子字段；未列出的键可能透传上游
  • mv (string): 模型版本；不传默认 chirp-v5。另支持 chirp-v6 / chirp-v6-wild / chirp-v6-mini。task=artist_consistency 时仅建议 chirp-v3-5-tau 或 chirp-v4-tau
  • persona_id (string): Persona ID。仅 task=artist_consistency 时必填。须先 POST /suno/submit/persona 创建成功后从 fetch 结果获取；无固定枚举，不可手写假 UUID。Persona 与创建账号绑定，不可跨账号复用创建步骤。
  • prompt (string): 自定义模式：新歌歌词；续写/补段/重制/混搭等也常用。task=remaster 时上游必填
  • tags (string): 风格标签，逗号分隔，如 "pop, piano, emotional"。可空
  • task (string): 特殊任务类型；不传则为普通生成（灵感/自定义/纯音乐） ["extend", "upload_extend", "infill", "fixed_infill", "infill_intro", "infill_outro", "cover_infill", "cover_extend", "artist_infill", "artist_consistency", "cover", "image_to_song", "video_to_song", "concat", "sound", "underpainting", "remaster", "vox", "mashup_condition"]
  • task_id (string): 关联原任务 ID，用于渠道路由（可选）
  • title (string): 歌曲标题