Fish Audio查询音色模型API-AutoRouter

根据模型 ID 查询音色模型详情，包括状态、可见性、作者、试听样本与质量评估。

同步接口：提交后立即返回模型对象。模型 _id 可作为语音合成接口的 reference_id 使用。

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Endpoints

GET `/fishaudio/model/{id}`

查询音色模型详情

根据创建模型时返回的 _id 查询模型详情。无权访问或模型不存在时分别返回 403 / 404。

Headers

Name	Type	Required	Description
`Authorization`	string	Yes	请求身份认证。格式：`Bearer sk-xxxxxx`

Path Parameters

Name	Type	Required	Description
`id`	string	Yes	模型 ID

Responses

200: 查询成功

Content-Type: application/json

403: 无权限访问该模型

Content-Type: application/json

404: 模型不存在

Content-Type: application/json

请求示例

curl -X GET "https://api.autorouter.top/fishaudio/model/{id}" \
  -H "Authorization: Bearer sk-xxxxxx"

响应示例

{
  "_id": "7f8a9b0c1d2e3f4a5b6c7d8e",
  "type": "tts",
  "title": "My Voice",
  "description": "Cloned from a studio sample",
  "cover_image": "",
  "train_mode": "fast",
  "state": "trained",
  "tags": ["custom"],
  "samples": [],
  "created_at": "2026-09-20T01:00:00.000Z",
  "updated_at": "2026-09-20T01:00:00.000Z",
  "languages": ["en"],
  "visibility": "private",
  "lock_visibility": false,
  "default_text": "",
  "source": null,
  "licensed": false,
  "like_count": 0,
  "mark_count": 0,
  "shared_count": 0,
  "task_count": 0,
  "liked": false,
  "marked": false,
  "unliked": false,
  "author": {
    "_id": "64a1b2c3d4e5f67890123456",
    "nickname": "creator",
    "avatar": "https://example.com/avatar.png"
  }
}

响应字段说明：

Name	Type	Description
`_id`	string	模型 ID，可用于语音合成的 `reference_id`
`type`	string	模型类型。`tts` 为文本转语音，`svc` 为歌声转换
`title`	string	模型标题
`description`	string	模型描述，默认为空字符串
`cover_image`	string	封面图 URL，默认为空
`train_mode`	string	训练模式。`fast` 创建后立即可用；`full` 为完整训练
`state`	string	状态。枚举值：`created`、`training`、`trained`、`failed`
`tags`	string[]	标签列表
`samples`	object[]	试听样本，默认空数组
`created_at`	string	创建时间，ISO 8601
`updated_at`	string	更新时间，ISO 8601
`languages`	string[]	语种列表
`visibility`	string	可见性。枚举值：`public`、`unlist`、`private`
`lock_visibility`	boolean	是否锁定可见性，默认 `false`
`dmca_taken_down`	boolean \| null	是否因 DMCA 下架
`takedown_category`	string \| null	下架类别：`dmca`、`policy`
`default_text`	string	默认试听文本
`source`	string \| null	来源。全部 voice 校验通过时可能为 `voice_design`
`licensed`	boolean	是否为 Fish Audio 已授权音色
`pvc_release_state`	string \| null	PVC 发布状态：`released`、`retiring`
`pvc_notice_period_months`	integer \| null	PVC 通知期（月）
`pvc_released_at`	string \| null	PVC 发布时间
`pvc_retire_requested_at`	string \| null	PVC 退役申请时间
`pvc_retire_effective_at`	string \| null	PVC 退役生效时间
`quality`	object \| null	音频质量评估
`like_count`	integer	点赞数
`mark_count`	integer	收藏数
`shared_count`	integer	分享数
`task_count`	integer	使用次数
`liked`	boolean	当前用户是否点赞
`marked`	boolean	当前用户是否收藏
`unliked`	boolean	当前用户是否点踩
`author`	object	作者信息

statestring（必选）

模型状态。

created：已创建
training：训练中
trained：已完成，可用于语音合成
failed：训练失败

train_mode=fast 时通常很快变为 trained。

authorobject（必选）

作者信息。

_idstring（必选）

作者用户 ID。

nicknamestring（必选）

作者昵称。

avatarstring（必选）

作者头像 URL。

qualityobject | null（可选）

音频质量评估。未评估时为 null。

audiosobject[]（可选）

各参考音频的质量详情。每项包含：

filename（string，必选）：文件名
duration_ms（number，必选）：时长（毫秒）
language（string，可选）：语种，默认 unknown
quality（object，可选）：质量分数字典
quality_passed（boolean，可选）：是否通过质量检查，默认 false
quality_reason（string，可选）：质量说明

created_atstring（必选）

质量评估创建时间，ISO 8601。

updated_atstring（必选）

质量评估更新时间，ISO 8601。

错误处理

HTTP 401 / 403 鉴权错误

401 Unauthorized：API Key 无效或已过期
403 Forbidden：无权访问该模型（私有模型或 token 无权限）

HTTP 404 模型不存在

指定的 id 不存在。请确认模型 ID 是否正确、是否已被删除。

HTTP 402 余额不足

返回 insufficient user quota。请前往 AutoRouter 控制台充值。

HTTP 503 服务过载

服务端负载过高，无法处理请求。请稍后重试。

查询模型

statestring（必选）

authorobject（必选）

属性

qualityobject | null（可选）

属性

目录