--- title: Fish Audio List-Voices | RunAPI description: 提交同步List Voices请求，并在同一响应中接收结果。 url: https://runapi.ai/zh-CN/docs/api/fish-audio/list-voices.md canonical: https://runapi.ai/zh-CN/docs/api/fish-audio/list-voices locale: zh-CN --- > HTML version: https://runapi.ai/zh-CN/docs/api/fish-audio/list-voices > Site index for agents: https://runapi.ai/llms.txt # Fish Audio List-Voices ## 概览 提交List Voices请求，并直接使用同一响应返回的结果。 ### 快速开始 1. 创建 API Key，并将其设置为 RUNAPI_API_KEY。 2. 发送与请求 Schema 匹配的 POST 请求。 3. 从成功响应正文中读取结果。 ## 端点 GET /api/v1/fish_audio/voices 基础 URL: https://runapi.ai API 版本: v1 身份验证: Authorization: Bearer YOUR_API_TOKEN ## 支持的模型 打开模型页可查看当前价格、限流和商业使用详情。 - [Fish Audio](https://runapi.ai/models/fish-audio) ## 请求 Schema 只发送此端点声明的字段。 ### 请求体 ```json { "page_number": { "default": 1, "min": 1, "type": "integer" }, "page_size": { "default": 10, "max": 100, "min": 1, "type": "integer" } } ``` ## 成功响应 HTTP 200 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "page_number": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" }, "voices": { "items": { "properties": { "name": { "type": "string" }, "state": { "enum": [ "created", "training", "trained", "failed" ], "type": "string" }, "voice_id": { "type": "string" } }, "required": [ "voice_id", "state" ], "type": "object", "unevaluatedProperties": false }, "type": "array" } }, "required": [ "voices", "total", "page_number", "page_size", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "page_number": 1, "page_size": 10, "total": 1, "voices": [ { "name": "Studio Narrator", "state": "trained", "voice_id": "voice_reference_narrator" } ] } ``` ## 错误 HTTP 401 - GET /api/v1/fish_audio/voices 此响应不包含正文。 ## 错误 HTTP 400 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "page_number_must_be_greater_than_or_equal_to_1", "message": "page_number must be greater than or equal to 1" } } ``` ## 错误 HTTP 402 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "insufficient_balance", "message": "Insufficient balance" } } ``` ## 错误 HTTP 403 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "api_token_credit_limit_exceeded", "message": "API key credit limit exceeded" } } ``` ## 错误 HTTP 409 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "request_conflict", "message": "The request uses features that are not supported for the selected model" } } ``` ## 错误 HTTP 429 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "rate_limited", "message": "Rate limit reached. Please retry later." } } ``` ## 错误 HTTP 503 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "service_unavailable", "message": "Service under maintenance, please try again later" } } ``` ## 错误 HTTP 504 - GET /api/v1/fish_audio/voices ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "error": { "code": "timeout_error", "message": "The request timed out" } } ``` ## 生成的代码示例 直接使用 cURL，或安装所用语言的 SDK。每个示例都会提交本参考中经过验证的请求。 ### curl ```curl curl -X GET https://runapi.ai/api/v1/fish_audio/voices\?page_number\=1\&page_size\=10 \ -H 'Authorization: Bearer YOUR_API_TOKEN' ``` ### javascript #### 安装 ```bash npm install @runapi.ai/fish-audio ``` ```javascript import { FishAudioClient } from "@runapi.ai/fish-audio"; const client = new FishAudioClient({ apiKey: process.env.RUNAPI_API_KEY }); const result = await client.listVoices.run({ "page_number": 1, "page_size": 10 }); ``` ### python #### 安装 ```bash pip install runapi-fish-audio ``` ```python import os from runapi.fish_audio import FishAudioClient client = FishAudioClient(api_key=os.environ["RUNAPI_API_KEY"]) result = client.list_voices.run( page_number=1, page_size=10 ) ``` ### go #### 安装 ```bash go get github.com/runapi-ai/fish-audio-sdk/go@latest ``` ```go package main import ( "context" "log" "os" "github.com/runapi-ai/core-sdk/go/option" fishaudio "github.com/runapi-ai/fish-audio-sdk/go/fishaudio" ) func main() { client, err := fishaudio.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } result, err := client.ListVoices.Run(context.Background(), fishaudio.ListVoicesParams{ PageNumber: 1, PageSize: 10, }) if err != nil { log.Fatal(err) } _ = result } ``` ### ruby #### 安装 ```bash gem install runapi-fish-audio ``` ```ruby require "runapi/fish_audio" client = RunApi::FishAudio::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY")) result = client.list_voices.run( page_number: 1, page_size: 10 ) ``` ### java #### 安装 ```kotlin implementation("ai.runapi:runapi-fish-audio") ``` ```java import ai.runapi.fishaudio.FishAudioClient; import ai.runapi.fishaudio.types.ListVoicesParams; import ai.runapi.fishaudio.types.VoicesResponse; public final class Example { public static void main(String[] args) { FishAudioClient client = FishAudioClient.builder() .apiKey(System.getenv("RUNAPI_API_KEY")) .build(); VoicesResponse result = client.listVoices().run( ListVoicesParams.builder() .pageNumber(1) .pageSize(10) .build() ); } } ``` ### php #### 安装 ```bash composer require runapi-ai/fish-audio ``` ```php listVoices->run([ "page_number" => 1, "page_size" => 10 ]); ``` ## 相关指南 - [API 身份验证](https://runapi.ai/docs/guides/authentication.md) - [快速开始](https://runapi.ai/docs/guides/task-api/quickstart.md) --- ## More from RunAPI - [Home](https://runapi.ai/.md) - [模型](https://runapi.ai/zh-CN/models.md) - [AI 视频 API 对比](https://runapi.ai/zh-CN/ai-video-api-comparison.md) - [OpenClaw 集成](https://runapi.ai/zh-CN/openclaw.md) - [OpenClaw 最佳 API](https://runapi.ai/zh-CN/best-api-for-openclaw.md) - [OpenClaw 图片生成](https://runapi.ai/zh-CN/openclaw-image-generation.md) - [Hermes 智能体集成](https://runapi.ai/zh-CN/hermes-agent.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [Claude API 定价](https://runapi.ai/zh-CN/claude-api-pricing.md) - [ChatGPT API 定价](https://runapi.ai/zh-CN/chatgpt-api-pricing.md) - [OpenAI API 定价](https://runapi.ai/zh-CN/openai-api-pricing.md) - [Gemini API 定价](https://runapi.ai/zh-CN/gemini-api-pricing.md) - [Claude Code 定价](https://runapi.ai/zh-CN/claude-code-pricing.md) - [Claude Code API](https://runapi.ai/zh-CN/claude-code-api.md) - [Claude Code 对比 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Claude Max 对比 API](https://runapi.ai/zh-CN/claude-max-vs-api.md) - [Requesty 替代方案](https://runapi.ai/zh-CN/requesty-alternative.md) - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [Skills](https://runapi.ai/zh-CN/skills.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [反馈](https://runapi.ai/) - [联系](mailto:support@runapi.ai) - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "TechArticle", "headline": "Fish Audio List-Voices", "description": "提交同步List Voices请求，并在同一响应中接收结果。", "url": "https://runapi.ai/zh-CN/docs/api/fish-audio/list-voices", "mainEntityOfPage": "https://runapi.ai/zh-CN/docs/api/fish-audio/list-voices" } ] ```