API 文档
毕力可开放服务提供 OpenAI 兼容风格的 HTTP 接口，几行代码即可接入。
接入概览
所有请求基于 HTTPS，通过请求头中的 API Key 鉴权：
| Base URL | https://yixoaka.com/v1 |
|---|---|
| 鉴权方式 | Authorization: Bearer <API Key> |
语音合成 POST /v1/audio/speech
将文本合成为语音。支持两种返回格式：pcm 为实时分块流（48kHz、16-bit、单声道 s16le，可边生成边播放，首包延迟低）；wav 为完整 WAV 文件，生成结束后一次性返回。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定为 yixotts |
input | string | 是 | 待合成文本，单次上限 2000 字符，更长文本请分段合成 |
voice | string | 是 | 音色 ID，从 GET /v1/voices 获取 |
response_format | string | 否 | pcm（默认）或 wav |
accent | string | 否 | 维吾尔语口音：kashgar（喀什）或 hotan（和田）；不传为标准维语，仅支持 supported_accents 包含该值的音色 |
curl 示例：
curl https://yixoaka.com/v1/audio/speech \
-H "Authorization: Bearer <API Key>" \
-H "Content-Type: application/json" \
-d '{
"model": "yixotts",
"input": "你好，世界。",
"voice": "gg_mandarin_chinese_wavenet_1",
"response_format": "pcm"
}' \
--output speech.pcmJavaScript 流式接收示例：
const response = await fetch("https://yixoaka.com/v1/audio/speech", {
method: "POST",
headers: {
Authorization: "Bearer <API Key>",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "yixotts",
input: "你好，世界。",
voice: "gg_mandarin_chinese_wavenet_1",
response_format: "pcm",
}),
});
// pcm 为 48kHz 16-bit 单声道 s16le 流，收到即可喂给 AudioContext 播放
const reader = response.body.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) break;
// value: Uint8Array PCM 分块
}音色列表 GET /v1/voices
返回当前可用的全部预置音色（含维吾尔语与中文音色）及其 ID；supported_accents 为空数组表示标准口音，包含 kashgar / hotan 时可传对应 accent：
curl https://yixoaka.com/v1/voices \
-H "Authorization: Bearer <API Key>"用量与余额 GET /v1/usage
自助对账：返回实时余额（quota，单位字符）、累计已扣字符数、总调用次数、近 30 天按天用量（字符数 + 调用次数），以及首充赠送的测试额度（trial，未用完且在有效期内时返回）。计费口径与合成一致：1 字符 = 1 token，仅成功出流的请求才计入。
curl https://yixoaka.com/v1/usage \
-H "Authorization: Bearer <API Key>"返回示例：
{
"quota": 19101,
"used_chars": 731299,
"request_count": 7126,
"unit": "char",
"daily": [{ "date": "2026-08-28", "chars": 250956, "requests": 2036 }],
"trial": null
}消费流水 GET /v1/usage/records
逐条消费记录，按结算时间倒序。参数：limit（默认 100，上限 500）、before（unix 秒游标，只取更早的记录）。翻页时把上一页返回的 next_before 带回来即可。
curl "https://yixoaka.com/v1/usage/records?limit=100" \
-H "Authorization: Bearer <API Key>"AI 助手接入（Skill 下载）
把下面的技能文件交给你的 AI 助手（Claude Code / Kimi / Codex 等），它就能直接学会调用毕力可语音合成 API。文件内包含接口说明、音色列表与流式播放要点。