LogoAI Music API
登录

API 接口

更新日志

开发者更新

API 更新日志

集中查看已上线的 API 能力、兼容性说明，以及集成是否需要调整。

最近更新

2026年9月17日

发布记录

共 6 条更新
  1. 变更
    向后兼容POST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    被拒绝的请求同步返回 422 或 500 并立即退款

    创建端点现在会同步报告校验拒绝并退还积分，而不是返回 200 后任务永远不完成。

    变更内容

    • 422 表示某个请求参数在校验中被拒绝，message 会指出需要修正的字段（如 title 或 extensionStartTime）。
    • 500 表示临时故障，请稍后重试。
    • 两种响应均包含 data.task_id、data.refunded 与 workId，任务状态标记为 FAILED。
    • 被接受后失败的任务（包括 extend）会标记为 FAILED 并附带 fail_message，积分自动退还。
    • 此前此类请求返回 200，任务会一直停留在 IN_PROGRESS。

    集成影响

    收到 422 时修正提示的参数；收到 500 时稍后重试。两种响应均包含 data.refunded。

    查看接口文档
  2. 变更
    向后兼容POST /v2/extendAll models

    extend 请求自动规范文本与起始时间，不再因此失败

    POST /v2/extend 现在会截断超长的自定义模式文本并收敛 extensionStartTime，这些字段不会再导致提交被拒绝。

    变更内容

    • title 上限 80 字符，超出部分会被截断。
    • prompt 上限 5000 字符，style 上限 1000 字符，超出部分会被截断。
    • extensionStartTime 会被收敛到 1 ～（源音频时长 - 1）秒；缺失或无效时使用源曲目末尾。
    • 扩展按原曲目模型价格计费，由 chirp-v6（chirp-v5 / chirp-v5-5 曲目）或 chirp-v6-mini（更早的旧模型曲目）生成。

    集成影响

    本次更新向后兼容。请将 title 控制在 80 字以内以避免被截断。

    查看接口文档
  3. 变更
    向后兼容POST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    旧模型 chirp-v3-5 ~ chirp-v5-5 由 chirp-v6 家族提供服务

    仍在传旧模型标识的请求可继续正常工作，并保持原有价格。

    变更内容

    • chirp-v5、chirp-v5-5（12 积分）由 chirp-v6 提供服务。
    • chirp-v3-5、chirp-v4-0、chirp-v4-5、chirp-v4-5-plus、chirp-v4-5-all 由 chirp-v6-mini 提供服务。
    • 每个旧模型标识仍按其历史价格计费（5、8、10 或 12 积分）。
    • status、feed、callback 结果中的 model_name 现在始终返回实际生成音频的公开模型名，例如 chirp-v6-mini。
    • 未传 model 字段时按 5 积分基础档计费，并由 chirp-v6-mini 提供服务。

    集成影响

    无需修改。方便时可将 model 字段更新为 chirp-v6 或 chirp-v6-mini。

    查看接口文档
  4. 新增
    向后兼容POST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    新增 chirp-v6、chirp-v6-mini、chirp-v6-wild 模型

    当前模型阵容更新为 chirp-v6 家族，可用于 generate、upload-cover 与 extend。

    变更内容

    • chirp-v6 为旗舰模型，chirp-v6-mini 为快速经济档，chirp-v6-wild 为更具实验性的变体。
    • chirp-v6 与 chirp-v6-wild 每次请求 12 积分，chirp-v6-mini 为 10 积分。
    • 所有模型统一文本上限：自定义 prompt 5000、灵感 prompt 3000、style 1000、title 80（upload-cover 为 100）。超长内容会被截断而不是拒绝。
    • 扩展 chirp-v6 曲目时使用同一模型；自定义模式的 generate 请求会透传 duration 字段。

    集成影响

    本次更新向后兼容。新集成建议使用 chirp-v6-mini 或 chirp-v6。

    查看接口文档
  5. 新增
    向后兼容POST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    通过 image_urls 实现图片生成音乐

    POST /v2/generate 与 POST /v2/upload-cover/generate 现在支持传入参考图片，用画面氛围影响生成的音乐。

    变更内容

    • 以数组形式传入 image_urls，最多 5 个可公网访问的图片 URL。
    • 支持 JPEG、JPG、PNG、WEBP，单张不超过 10MB。
    • 图片仅在灵感模式（generate）和非自定义模式（upload-cover）生效；自定义模式下会被静默忽略。
    • 图片输入在模型价格基础上每次请求额外消耗 1 积分。
    • 提供图片时文字提示可省略；两者结合可更精确地控制结果。

    集成影响

    本次更新向后兼容。只有希望图片影响结果时才需要添加 image_urls。

    查看接口文档
  6. 新增
    向后兼容POST /v2/generatechirp-v5-5

    chirp-v5-5 支持自定义生成时长

    使用 chirp-v5-5 的自定义模式请求现在可以指定目标音乐时长。

    变更内容

    • duration 字段仅适用于 chirp-v5-5 的自定义模式。
    • 可传入 10 至 360 秒的数值。
    • 未提供或值无效时使用 20 秒。
    • 其他模型和灵感模式会忽略此字段。

    集成影响

    此更新向后兼容，现有请求无需修改即可继续使用。

    查看接口文档