Riffusion 任务 API 集成与使用指南

简介Riffusion 任务 API 的主要功能是通过输入由 Riffusion 音频生成 API 生成的任务 ID 来查询任务的执行状态。通过集成 Riffusion 任务 API开发者可以轻松地利用这一强大的功能以便更高效地管理音频生成任务。在本文中我们将详细介绍如何集成 Riffusion 任务 API并提供示例代码帮助您快速上手。环境准备/前置条件在使用 Riffusion 任务 API 前您需要完成以下步骤申请 Riffusion 音频生成 API 的服务访问 Riffusion Audios Generation API。从 Riffusion 音频生成 API 中复制任务 ID。访问 Riffusion Tasks API 页面申请相关服务点击“获取”按钮。如果您尚未注册或登录将自动重定向到 登录页面 进行注册或登录。首次申请用户可享受免费配额。详细步骤1. 请求示例Riffusion 任务 API 可以用于查询 Riffusion 音频生成 API 的结果。我们使用从 Riffusion 音频生成 API 返回的任务 ID 进行示例假设我们有一个任务 ID20068983-0cc9-4c6a-aeb6-9c6a3c668be0。任务示例图2. 设置请求头和请求体请求头包括accept: 指定响应格式为 JSON设置为application/json。authorization: 调用 API 的密钥申请后可直接选择。请求体包括id: 上传的任务 ID。action: 任务的操作方法。设置示例如下3. 代码示例页面右侧会自动生成多种语言的代码示例示例如下CURL 示例curl -X POST https://api.acedata.cloud/riffusion/tasks \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { id: a6e0d456-189b-4c78-9232-2fe72166ab39, action: retrieve }4. 响应示例成功请求后API 将返回任务的详细信息示例如下{ _id: 6858b5fb550a4144a57afd78, id: a6e0d456-189b-4c78-9232-2fe72166ab39, ... response: { success: true, ... } }5. 批量查询操作若要查询多个任务 ID 的详细信息操作方法需要设置为retrieve_batch。请求体如下{ ids: [a6e0d456-189b-4c78-9232-2fe72166ab39, another-task-id], action: retrieve_batch }CURL 示例curl -X POST https://api.acedata.cloud/riffusion/tasks \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { ids: [a6e0d456-189b-4c78-9232-2fe72166ab39], action: retrieve_batch }6. 错误处理调用 API 时如果发生错误API 将返回相应的错误代码和消息。例如400 token_mismatched: 错误请求可能是缺少或无效的参数。401 invalid_token: 未授权授权令牌无效或缺失。错误响应示例{ success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }总结通过本文您已经学习了如何使用 Riffusion 任务 API 查询单个或批量任务的详细信息。希望本文能帮助您更好地集成和使用该 API。如有任何问题请随时联系技术支持团队。相关链接Ace Data CloudRiffusion Audios Generation APIRiffusion Tasks API标签Riffusion #API集成 #音频生成 #技术教程 #开发者指南