媒体与音乐
使用本节了解不像普通聊天补全那样工作的资产生成流程，尤其是 AI 音乐任务。
使用本节了解不像普通聊天补全那样工作的资产生成流程，尤其是 AI 音乐任务。
从这里开始
| 任务 | 页面 | 结果 |
|---|---|---|
| 理解何时使用音乐专属工作流 | 概览 | 判断工作负载属于聊天、媒体生成还是 AI 音乐 |
| 创建歌曲、歌词、风格或封面图 | 音乐生成 | 用正确的提示词、模型和回调选项提交生成请求 |
| 转换已有音频、创建声线身份或导出 WAV/MV | 音乐转换 | 在后续流程中复用已有音频或已完成曲目 |
| 轮询任务并处理回调 | 音乐任务与 Webhook | 跟踪异步任务直到最终资产可用 |
| 查看常见工作流模式 | 音乐使用场景 | 为常见产品体验选择 route 顺序 |
API 契约
精确的兼容 Suno 路由契约请查看 AI 音乐 API。DashScope 图像和通用视频路由请查看 媒体 API。
媒体和音乐与聊天有什么不同
| 差异 | 需要设计什么 |
|---|---|
| 异步任务生命周期 | 保存 task ID，并轮询或处理回调直到成功或失败 |
| 生成资产较大 | 将输出 URL 和元数据与聊天消息分开存储 |
| 用户可感知等待时间 | 在 UI 中展示 pending、processing、succeeded 和 failed 状态 |
| 重试 | 尽量让重试具备幂等性，避免重复创建付费任务 |
| 权利和审核 | 决定产品如何处理上传音频、生成曲目和面向用户的审核 |
推荐工作流形状
- 使用安全占位 callback URL 或生产 HTTPS callback 端点创建任务。
- 将返回的 task ID 与用户、项目、提示词和所选模型一起保存。
- 轮询文档中的查询 route，或接收 webhook 回调。
- 只有当任务状态成功且存在输出 URL 时，才标记资产可用。
- 保留原始请求体和最终元数据，用于客服和重试分析，但不要记录私有 API key。
选择正确的 API 家族
| 输出 | 优先看 |
|---|---|
| 纯文本歌词、描述或策划提示词 | OpenAI 兼容 或其他文本 API 家族 |
| 图像生成或基于提示词的视频 | 媒体 API 和 视频生成 |
| 完整歌曲、翻唱、分轨、声线身份、WAV 或音乐视频工作流 | AI 音乐 API |
| 混合型产品流程 | 将文本、媒体和音乐任务拆成独立 route 调用，并分别处理错误 |
生产检查
上线前，请验证任务创建、轮询、回调可达性、重复回调处理、失败任务 UI、输出 URL 存储，以及额度或策略失败时展示给用户的错误信息。