把灵感,变成音乐。
描述声音、节奏和情绪,剩下的交给 Flow Music。
音频库
收藏每一次创作,找到下一次灵感。
全部作品
点击曲名查看详情任务记录
按北京时间查看每日任务数量与成败统计,追踪提交、开始、结束时间及执行耗时。
按天统计
按北京时间统计,选择日期查看当天全部状态账号池
在可用且未达并发上限的账号中,优先选择最久未使用的账号。
服务设置
调整账号调度和任务生命周期,保存后立即生效。
运行概览
账号是否可用、服务正在忙什么。
运行日志
记录任务与账号事件,凭据不会写入日志。
API 文档
生成纯音乐或指定歌词的歌曲,从提交任务到下载音频。
1. 地址与认证
对外 API 地址:。除健康检查和带签名的音频链接外,所有请求都要带上访问密码,把示例中的 YOUR_PASSWORD 替换为服务端配置的密码。
以下 curl 命令用于 Bash / Zsh,反斜杠必须在行尾。每首新作品使用新的 Idempotency-Key;重试同一请求时保持原键和参数不变。
2. 生成纯音乐
默认异步返回 HTTP 202 和任务编号;202 表示已接收,不代表生成成功。
3. 指定歌词生成歌曲
prompt 描述曲风、语言、人声、乐器和情绪;lyrics 填入完整歌词,并设置 instrumental: false。两种模型均支持传入这些参数。
支持中文、换行及 [Verse]、[Chorus]、[Bridge] 等结构提示。JSON 字符串内用 \n 表示换行。开启 instrumental: true 会忽略歌词。面板「开始创作」中关闭“纯音乐”即可填写歌词。生成模型不保证逐字演唱、固定结构或精确时长。
4. 查询状态与下载
保存提交响应的 id,替换下面的「任务编号」,每 2–5 秒查询一次,直到任务结束。
| status | 含义 | 下一步 |
|---|---|---|
queued | 排队等待账号 | 继续查询 |
running | 正在生成 | 继续查询 |
succeeded | 生成成功 | 读取 data 中的音频 |
failed | 生成失败 | 读取 error.code / error.message |
cancelled | 停止本地等待 | 上游可能继续生成及扣费 |
成功响应示例(精简字段,所有 ID 和链接均为示意):
通过 data[].url 或 data[].download_url 试听、下载,无需再附带密码。若有多个版本,可逐个保存。签名链接有效期 24 小时,重新查询任务可获取新链接;不要使用上游的 audio_url 代替本服务下载链接。
created_at、started_at、finished_at 单位为毫秒,url_expires_at 为秒。日志、任务和音频缓存默认保留 7 天,可在服务设置调整;任务清理后原链接也不可用,长期作品请自行保存。远程部署须将后端 publicBaseUrl 设置为可访问的根地址。
5. 模型、积分与套餐
核对日期:2026-09-30。以下是本项目支持列表,账号是否可调用仍取决于上游权限、余额和可用性。
| model | 名称 / 别名 | 输入 | 单次积分 |
|---|---|---|---|
lyria-3.5 | Lyria 3.5(默认) lyria / flowmusic | 歌词歌曲、纯音乐 | 模型专属扣费未核实,以官网为准 |
lyria-3-pro | Lyria 3 Pro lyria-pro | 歌词歌曲、纯音乐 | 模型专属扣费未核实,以官网为准 |
GET /v1/models 返回适配器支持列表,不实时检查账号权限,也不返回价格。
| Flow Music 套餐 | Google AI 对应会员 | 月度积分 | 官网估算歌曲数 | 官网并发上限 |
|---|---|---|---|---|
| Free | 无付费会员 | 每日补充 | 未列出 | 2 |
| Starter | AI Plus | 3,000 | 约 600 首 | 8 |
| Plus | AI Pro | 10,000 | 约 2,000 首 | 12 |
| Member | AI Ultra | 30,000 | 约 6,000 首 | 16 |
套餐折算约 5 积分/首(例如 10,000 ÷ 2,000)。这是官网套餐估算,不能作为每个模型或每次 API 请求固定扣 5 积分的承诺。一个任务可能返回多个版本,本服务不返回逐任务扣费账单。
官方说明有月度额度及每日补充,但公开页面未明确每日补充数量、具体刷新时刻、时区和结转规则;以账号订阅/积分页面为准。Flow Music 积分独立于其他 Google AI 积分。
「账号池 → 检查」可同步余额,显示的是最近检查结果。失败、超时或取消不保证退费;重新生成可能再次扣费。账号池不增加单个账号的额度,单账号并发建议不高于套餐上限。
来源:官方套餐 · 会员与积分说明 · Google AI Pro 权益。如官网调整,以账号当前显示为准。
6. 完整请求参数
| 参数 | 类型 / 默认值 | 说明 |
|---|---|---|
prompt | string / 必填 | 1–10000 字符;曲风、人声、乐器、情绪;传歌词时仍必填 |
model | string / lyria-3.5 | lyria-3.5 或 lyria-3-pro;支持上表别名 |
title | string / Untitled | 最多 160 字符 |
lyrics | string / 空 | 最多 20000 字符;结构标签可选 |
instrumental | boolean / false | true 为纯音乐并忽略歌词;面板开关初始开启,API 默认 false |
duration | integer / 不指定 | 目标时长提示;5–300 秒为本项目校验范围,不是官方精确时长参数,详见下方说明 |
bpm | integer / 自动 | 30–300,仅作为生成提示 |
seed | integer / 随机 | 0–2147483647;不承诺完全相同的音频输出 |
n | integer / 1 | 仅支持 1;上游可能附带其他版本 |
async | boolean / true | false 保持连接等待任务结束 |
audio_format | string / mp3 | mp3、wav、m4a |
response_format | string / url | url 或 b64_json;Base64 单文件最多 30 MB |
同步模式客户端/代理超时应大于任务超时(默认 600 秒)。b64_json 在成功的同步响应和任务查询中额外返回 data[].b64_json;任务列表只返回 URL。批量任务建议使用异步模式。
duration:目标时长,不保证精确秒数
不要将请求中的 duration 作为实际音频长度的保证。当前接入未使用官方独立的精确时长参数。
本项目把 "duration": 15 转成歌词末尾的 [End - 0:15];90 秒则转成 [End - 1:30],再随歌词提交上游。纯音乐也使用同样的提示方式。5–300 秒只是本项目允许的输入范围,不代表官方承诺支持这些精确时长,也不是输出音频的长度限制。
模型可能不遵循提示:2026-09-30 的一次实测中,请求 15 秒,实际输出约 61 秒。这是单次结果,不代表固定偏差。
不需要提示时请省略 duration,不要填写 0。响应中的 data[].duration 是上游返回的生成结果时长(秒),不是请求值;上游未提供有效时长时可能为 null。
当前项目不会自动裁剪、补静音或变速。需要严格固定长度时,请在生成后另行处理音频,并校验最终文件时长。
7. 接口一览
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /health | 健康检查,无需认证 |
| GET | /v1/models | 模型列表 |
| POST | /v1/audio/generations | 提交生成 |
| GET | /v1/audio/generations/:id | 查询任务 / 结果 |
| GET | /v1/audio/generations | 当前 Key 最近 100 条任务 |
| POST | /v1/audio/generations/:id/cancel | 停止本地等待 |
| POST | /v1/chat/completions | 聊天格式接入,支持 SSE |
/v1/music/generations 和 /v1/music/generations/:id 分别是提交、查询单个任务的兼容路径。
8. Chat Completions
仅支持文本消息,将所有 user 消息合并为音乐描述。可同时传 lyrics 与 instrumental: false。不保留跨请求对话上下文,也不把 system 消息作为上游指令。stream: true 返回 SSE 提交提示和最终音频链接,结束于 [DONE];这是状态/链接流,不是音频分片流。stream: false 等待完成后返回聊天响应及 data。
9. 幂等性与失败处理
Idempotency-Key 最长 128 字符。同一幂等键和相同生成参数返回原任务;参数冲突返回 HTTP 409。记录保留期过后,该键可创建新任务。请求中断时先按原任务 ID 查询,避免换键盲目重试。
提交/认证错误返回 {"code":400,"msg":"错误说明","error":{"code":"…","message":"错误说明"}},其中 code 对应 HTTP 状态码。仅在上游明确判定内容违规、错误码为 content_rejected 时,同步生成和任务查询返回 HTTP 400,error.code 为 content_rejected,msg 提示“提示词包含违规内容,未通过内容审核,请修改提示词后重试。”。异步新任务先返回 202,后续查询才返回违规结果。
generation_failed / tool_call_failure 是普通生成故障,不能据此判定内容违规。任务响应不包含 conversation_url 或 error.upstream;原始错误及会话信息仅保存在服务端用于排查。所有失败任务均提供经过整理的 msg。普通生成故障的任务查询仍返回 HTTP 200,请检查 status 和任务的 error;同步其他失败通常返回 HTTP 502,任务超时返回 HTTP 504。已经开始的 SSE 流保持 HTTP 200,违规错误事件包含 code: 400、msg 和 error,随后发送 [DONE]。
| 错误码 | 处理方式 |
|---|---|
| unauthorized | 检查 Authorization: Bearer 中的访问密码 |
| invalid_prompt / invalid_model / invalid_request / invalid_format | 根据参数表修正输入 |
| not_found | 检查任务编号和保留期 |
| no_accounts / session_expired | 导入账号、登录并检查会话 |
| queue_full / rate_limited | 降低并发,等待队列或账号冷却 |
| quota_exhausted | 等待额度恢复或使用有余额的账号 |
| idempotency_conflict | 重试须保持参数一致;新作品使用新键 |
| upstream_forbidden / upstream_network | 检查账号权限、服务端网络及代理 |
| content_rejected | 调整生成内容 |
| generation_failed | 普通生成失败,服务已自动重试一次仍失败;查看 msg,必要时提供任务 ID 联系服务提供方,同步返回 HTTP 502 |
| submission_unknown / timeout | 上游可能已生成或仍在生成,先检查官网再决定是否重试 |
完整文档及管理接口说明见项目 docs/API.md。