鱼音频生成 API 集成指南

在这篇文章中我们将介绍如何集成鱼音频生成 API该 API 能够通过输入提示词来克隆您的声音。这项技术的应用场景包括语音合成、自动化语音助手、以及任何需要个性化语音输出的应用。环境准备在使用鱼音频生成 API 之前您需要先申请相应的服务。请确保您已注册并登录到 Ace Data Cloud 平台。申请过程首先访问 鱼音频生成 API 页面。进入页面后点击“获取”按钮如下图所示如果您尚未登录或注册系统会自动引导您进行注册或登录。完成后您将自动返回到当前页面。首次申请时您将获得免费的配额允许您免费使用 API。基本用法了解基本用法后您需要输入以下几个参数prompt提示词action克隆操作voice_id声音 IDmodel模型名称您需要传入一个字段action值为generate并输入模型model当前主要使用fish-tts模型具体如下请求头部设置包括accept您希望接收的响应结果格式这里填入application/json表示 JSON 格式。authorization调用 API 的密钥申请后可直接选择。请求体需要设置如下字段model用于克隆声音的模型主要是fish-tts。action本次声音克隆任务的操作。prompt需要克隆的提示词。voice_id用于克隆的声音 ID。callback_url接收回调结果的 URL。完成设置后右侧将生成相应的代码如下图所示点击“尝试”按钮进行测试结果如下{ success: true, task_id: 5872ab00-3cf4-4040-a798-8510aaa16756, trace_id: 5eda3694-448a-4b72-af33-2acb3851ffe1, data: [ { audio_url: https://platform.r2.fish.audio/task/8a72ff9840234006a9f74cb2fa04f978.mp3 } ] }返回的结果包含多个字段具体描述如下success表示声音克隆任务的状态。data声音克隆任务的结果audio_url此次声音克隆任务的音频链接。我们可以看到已经获得了满意的声音信息只需根据data中的音乐链接地址获取克隆的声音。如果您希望生成相应的集成代码可以直接复制生成的代码例如CURL 代码如下curl -X POST https://api.acedata.cloud/fish/audios \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { action: speech, prompt: a white siamese cat, model: fish-tts, voice_id: d7900c21663f485ab63ebdb7e5905036 }异步回调由于鱼音频生成 API 的生成时间相对较长大约需要 1-2 分钟。如果 API 长时间未响应HTTP 请求将保持连接开放导致额外的系统资源消耗。因此该 API 还支持异步回调。总体过程为当客户端发起请求时指定一个额外的callback_url字段。API 将立即返回包含task_id字段信息的结果表示当前任务 ID。当任务完成后生成任务的结果将以 POST JSON 的形式发送到客户端指定的callback_url同时包含task_id字段以便通过 ID 关联任务结果。我们通过一个示例来具体理解该操作。首先Webhook 回调是一个可以接收 HTTP 请求的服务开发者应将其替换为自己的 HTTP 服务器 URL。为了演示我们使用公共 Webhook 示例网站 https://webhook.site/。打开该网站后将获得一个 Webhook URL如下图所示复制此 URL它可以用作 Webhook。样例 URL 为https://webhook.site/4815f79f-a40f-4078-ac85-1cc126b6bb34。接下来我们可以在填写相应参数时设置callback_url字段为上述 Webhook URL如下图所示点击运行后您会立即收到结果如下所示{ task_id: 2725a2d3-f87e-4905-9c53-9988d5a7b2f5 }片刻之后您可以在https://webhook.site/4815f79f-a40f-4078-ac85-1cc126b6bb34查看生成任务的结果如下图所示内容如下{ success: true, task_id: 2725a2d3-f87e-4905-9c53-9988d5a7b2f5, trace_id: e2d308bc-4df8-4c69-9369-a60f3c54f2b3, data: [ { audio_url: https://platform.r2.fish.audio/task/b627c2f7d38a4083a837570ba6d0962f.mp3 } ] }我们可以看到结果包含task_id字段其他字段与上述描述相似通过此字段可以关联任务。错误处理调用 API 时如果发生错误API 将返回相应的错误代码和消息。例如400 token_mismatched错误请求可能由于缺少或无效的参数。400 api_not_implemented错误请求可能由于缺少或无效的参数。401 invalid_token未经授权无效或缺少授权令牌。429 too_many_requests请求过多您已超出速率限制。500 api_error内部服务器错误服务器出现问题。错误响应示例{ success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }总结通过本文您已学习如何使用鱼音频生成 API 通过输入提示词克隆声音。希望本指南能帮助您更好地集成和使用该 API。如果您有任何疑问请随时联系技术支持团队。标签#API集成 #语音合成 #AceDataCloud #技术教程 #开发者指南