API 文档
OpenAI 兼容的语音合成接口 · 与你的网页账户共用字符额度
快速开始
- 在 用户中心 → API Keys 创建密钥（明文仅显示一次，请妥善保存）。
- 用下方任意语言的示例发起请求，密钥放在
Authorization: Bearer头。 - 调用成功后返回音频文件（默认 WAV），消耗的字符数从你的账户额度扣除。
Base URL
https://cinqak.cn/v1鉴权：Authorization: Bearer <你的 sk- 密钥>接口列表
POST
/v1/audio/speech文本转语音，返回音频GET
/v1/voices列出可用音色GET
/v1/usage当前额度与用量GET
/v1/usage/records用量明细（分页）创建语音 · POST /v1/audio/speech
请求参数
| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 固定 yixotts |
input | string | 待合成文本（维吾尔语或中文），最长 800 字符 |
voice | string | 音色 ID，见 /v1/voices |
accent | string | 可选，重音/风格参数 |
response_format | string | 可选，wav（默认）或 mp3 |
请求示例
curl https://cinqak.cn/v1/audio/speech \
-H "Authorization: Bearer $CINQAK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "yixotts",
"input": "سىنچاققا خۇش كەلدىڭىز",
"voice": "ug-female-01",
"response_format": "wav"
}' \
--output result.wavfrom openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://cinqak.cn/v1",
)
response = client.audio.speech.create(
model="yixotts",
input="سىنچاققا خۇش كەلدىڭىز",
voice="ug-female-01",
)
response.stream_to_file("result.wav")import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://cinqak.cn/v1",
});
const res = await client.audio.speech.create({
model: "yixotts",
input: "سىنچاققا خۇش كەلدىڭىز",
voice: "ug-female-01",
});
const buffer = Buffer.from(await res.arrayBuffer());
import { writeFileSync } from "node:fs";
writeFileSync("result.wav", buffer);列出音色 · GET /v1/voices
curl https://cinqak.cn/v1/voices \
-H "Authorization: Bearer $CINQAK_API_KEY"返回 { "object": "list", "default": "...", "data": [ ... ] }，data 中每项含 id、name、language。
查询额度 · GET /v1/usage
curl https://cinqak.cn/v1/usage \
-H "Authorization: Bearer $CINQAK_API_KEY"返回 quota（总字符）、used_chars（已用）、request_count（请求数）、daily（近 30 天）。
用量明细 · GET /v1/usage/records
分页参数：limit（≤500，默认 50）、before（上一页 next_before 游标）。
curl "https://cinqak.cn/v1/usage/records?limit=20" \
-H "Authorization: Bearer $CINQAK_API_KEY"AI 编程助手 Skill
将下列 Skill 安装到 Cline / Claude / Cursor 等支持 Skill 的客户端，即可用自然语言调用本接口合成语音。
name: cinqak-tts
description: 通过 Cinqak OpenAI 兼容接口进行维吾尔语 / 中文语音合成（TTS）。当用户需要文字转语音、批量配音、脚本生成音频时使用。