API 文档

获取并安全保存 API Key

身份验证应在应用服务端完成。不要把生产密钥放入浏览器代码、移动端包、日志或公开仓库。

1. 1创建账号，在控制台打开 API Key 页面。
2. 2复制密钥，并保存到服务端密钥管理器或加密环境变量中。
3. 3通过 Authorization 请求头以 Bearer token 发送；一旦泄露应立即轮换。

快速开始

创建异步音乐任务，保存返回的 workId，再轮询 feed 接口直到完成。设置服务端密钥后，下方请求即可运行。

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

仓库内示例使用 UDIOAPI_KEY、有限次数轮询和结构化错误处理，不依赖第三方包。发布 GitHub fork 前请移除全部密钥。

API 端点

默认音乐生成请使用 /v2/generate。MiniMax 是已接入的提供商，通过 /v2/minimax/generate 使用，并不是默认音乐生成模型。

错误处理

将 HTTP 状态码和结构化响应体视为集成契约的一部分。可记录 workId 和自己的请求 ID，但绝不能记录 API Key。

不要重试内容审核失败或其他终止态失败。向用户展示返回的 fail_message 或 error_message，以便调整输入。

更新日志摘要

与兼容性相关的 API 变更集中在此处，并链接到受影响的接口文档。