静觅 ·

Fish Voices Generation API 对接说明

💡 原文中文，约5400字，阅读约需13分钟。

📝

内容提要

本文介绍了Fish Voices Generation API的对接方法，包括申请服务、获取API密钥和通过音频链接创建音色的步骤。API支持异步回调，用户可指定callback_url以接收任务结果。文中还提供了错误处理示例和使用流程。

🎯

使用 Fish Voices Generation API 需要先申请服务并获取 API 密钥。
基本使用方法是输入音色的音频链接（voice_url）以获得处理结果。
请求头中需要设置 accept 和 authorization，请求体中需要包含 voice_url、title、image_urls、description 和 callback_url。
API 支持异步回调，用户可以指定 callback_url 接收任务结果。
如果 API 长时间无响应，HTTP 请求会保持连接，因此建议使用异步回调。
错误处理示例包括常见错误代码，如 token_mismatched、invalid_token 和 api_error。

🔎

在申请 Fish Voices Generation API 服务时，用户需确保已完成注册并登录。首次申请时，系统会提供免费额度，适合新用户进行测试和探索。建议用户在申请前仔细阅读相关条款，以避免后续使用中的不必要麻烦。

由于音色生成可能需要1-2分钟，使用异步回调可以有效避免长时间等待造成的系统资源浪费。开发者应合理设置 callback_url，以便及时接收任务结果，提升用户体验。

在使用 API 时，了解常见的错误代码及其含义至关重要。比如，token_mismatched 和 invalid_token 错误可能导致请求失败，开发者应提前做好错误处理机制，以便快速定位和解决问题。

❓

要使用 Fish Voices Generation API，首先需要访问对应页面申请服务，点击「Acquire」按钮并登录或注册账户。

基本使用方法是输入音色的音频链接（voice_url），并设置请求头和请求体，然后发送请求以获得处理结果。

API 会返回错误代码和信息，例如 token_mismatched、invalid_token 和 api_error，用户可以根据这些信息进行相应处理。

请求头需要设置 accept 和 authorization，请求体需包含 voice_url、title、image_urls、description 和 callback_url。

用户可以指定 callback_url，API 会在任务完成后通过 POST JSON 形式将结果发送到该 URL，包含任务 ID 以便关联。

用户可以通过指定的 callback_url 接收处理结果，API 会返回一个包含 task_id 的响应，任务完成后结果会发送到该 URL。

🏷️