⚡ AI API 中转站

多厂商大模型统一调度 · 一个 Key 调用所有 AI 能力 · 后台随时切换模型路由

快速开始：所有接口均为 POST + JSON，Base URL 为 https://hub.nextech.club。请求需在 Header 携带 Authorization: Bearer {API_KEY}（API Key 由管理员分配）。返回统一格式：{success, content|audio_url|image_url|video_url, error, model, latency_ms}。

📡 接口总览

POST

💬 文本对话

/api/chat

通用对话、问答、文案生成。messages 数组，支持多轮对话与 system 提示。

POST

🖼️ 识图生图

/api/vision

识图（image_url）走千问 VL；生图（prompt）走豆包 Seedream-5.0。

POST

💻 代码生成

/api/code

根据需求生成代码，可选 language 指定编程语言。

POST

🎬 视频生成

/api/video

文生视频（通义万相）。耗时约 30~90 秒，返回 mp4 链接。

POST

🗣️ 语音合成

/api/voice

文本转语音（qwen-tts）。音频转存本站，返回稳定 audio_url。

POST

👂 语音识别

/api/asr

音频转文字（paraformer-v2）。传入音频公网 URL 返回文本。

POST

📤 音频上传

/api/upload

multipart 上传本地音频（App 录音场景），返回 file_url 供 /api/asr 识别。

GET

🎤 音色列表

/api/voices

语音合成可用音色（名称/性别/风格），App 设置页渲染用。

POST

🎵 音乐生成

/api/music

已停用上游服务暂停，恢复时间另行通知。

📖 接口详情

1. 文本对话 `/api/chat`

参数	类型	必填	说明
messages	array	是	对话消息，如 [{"role":"user","content":"你好"}]，支持 system/user/assistant
temperature	float	否	随机性，0~2，默认由模型决定
max_tokens	int	否	最大输出 token 数
top_p	float	否	核采样
stream	bool	否	true 时 SSE 流式输出

curl -X POST https://hub.nextech.club/api/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {API_KEY}" \
  -d '{
    "messages": [
      {"role": "system", "content": "你是一个科普讲解员"},
      {"role": "user", "content": "太阳有多大？"}
    ],
    "temperature": 0.7
  }'

2. 识图生图 `/api/vision`

两种模式，按入参自动区分：

模式	入参	说明
识图	messages（含 image_url）	千问 VL-Max 图片理解，content 为数组：[{"type":"text"...},{"type":"image_url","image_url":{"url":"..."}}]
生图	prompt（+ size 可选）	豆包 Seedream-5.0 文生图，最低 1920x1920（低于自动提升），返回 image_url

# 识图
curl -X POST https://hub.nextech.club/api/vision \
  -H "Authorization: Bearer {API_KEY}" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":[
        {"type":"text","text":"这张图里有什么？"},
        {"type":"image_url","image_url":{"url":"https://example.com/pic.png"}}
  ]}]}'

# 生图
curl -X POST https://hub.nextech.club/api/vision \
  -H "Authorization: Bearer {API_KEY}" -H "Content-Type: application/json" \
  -d '{"prompt":"一只可爱的橘猫，卡通风格","size":"1920x1920"}'

3. 代码生成 `/api/code`

参数	类型	必填	说明
messages	array	是	需求描述
language	string	否	编程语言，如 python / javascript，自动注入系统提示
temperature / max_tokens / top_p / stream	-	否	同 /api/chat

4. 视频生成 `/api/video`

参数	类型	必填	说明
prompt	string	是	视频描述
duration	int	否	时长（秒），拼入描述
resolution	string	否	分辨率，如 1080p，拼入描述
style	string	否	风格，拼入描述

⚠️ 生成耗时 30~90 秒，请求需耐心等待；返回 video_url 为临时链接（约 24 小时有效），请及时转存。

5. 语音合成 `/api/voice`

参数	类型	必填	说明
text	string	是	要合成的文本
format	string	否	mp3（默认）/ wav
voice	string	否	音色，如 Cherry / Serena / Ethan，默认 Cherry
sample_rate	int	否	采样率，默认 48000

curl -X POST https://hub.nextech.club/api/voice \
  -H "Authorization: Bearer {API_KEY}" -H "Content-Type: application/json" \
  -d '{"text":"你好，欢迎参观","format":"mp3","voice":"Cherry"}'
# 返回: {"success":true,"audio_url":"https://hub.nextech.club/assets/audio/xxx.mp3",...}

可用音色（App 可调 GET /api/voices 获取）：

音色	性别	风格描述
Cherry	女	温暖甜美，适合陪伴倾诉
Serena	女	沉稳知性，适合谈心
Ethan	男	温和低沉，适合安抚

6. 语音识别 `/api/asr`

参数	类型	必填	说明
file_url	string	是	音频文件公网 URL（mp3/wav/flac/ogg），建议为本站 /assets/audio/ 下的链接
language_hint	string	否	语言提示，如 zh / en

curl -X POST https://hub.nextech.club/api/asr \
  -H "Authorization: Bearer {API_KEY}" -H "Content-Type: application/json" \
  -d '{"file_url":"https://hub.nextech.club/assets/audio/demo.mp3"}'
# 返回: {"success":true,"content":"识别出的文本","text":"...","model":"通义Paraformer语音识别",...}

参数确认（App 对接参考）：

项	说明
language_hint	支持 zh / en / yue（粤语）等，不传自动检测；zh 可覆盖中英混说；四川话等方言暂不支持
VAD 断句	服务端自动静音断句，无独立参数；App 端约定「停顿 2~3 秒视为说完」由录音侧控制
音频时长	建议 ≤60 秒（配合 /api/upload 硬限制 60s/10MB）；超长音频可能超出中转 120s 超时
识别耗时	典型 1~5 秒（与音频时长正相关），App loading 文案可据此设计

7. 音频上传 `/api/upload`

解决 App 本地录音无公网 URL 的问题：先上传拿 file_url，再调 /api/asr 识别。识别结果建议客户端缓存，避免重复上传。

项	说明
方法/格式	POST，multipart/form-data，字段名 `file`（二进制音频）
支持格式	mp3 / wav / flac / pcm（16kHz 单声道 16bit 最佳）
大小上限	10 MB（音频时长建议 ≤60 秒）
鉴权	Authorization: Bearer {API_KEY}，与其它接口一致
存储	/assets/audio/upload_*.ext，服务端每日自动清理 7 天前的上传文件
客户端超时	建议连接/读取超时 ≥30 秒（10MB 上传 + 落盘）

curl -X POST https://hub.nextech.club/api/upload \
  -H "Authorization: Bearer {API_KEY}" \
  -F "file=@recording.wav"
# 返回: {"success":true,"file_url":"https://hub.nextech.club/assets/audio/upload_xxx.wav",
#        "format":"wav","size_bytes":128000,"error":null,"model":null,"latency_ms":42}

8. 音色列表 `/api/voices`

返回语音合成可用音色（名称/性别/风格），App 启动时拉取，设置页渲染引导文案。

curl https://hub.nextech.club/api/voices \
  -H "Authorization: Bearer {API_KEY}"
# 返回: {"success":true,"voices":[{"name":"Cherry","gender":"女","style":"温暖甜美,适合陪伴倾诉"},...]}

9. 音乐生成 `/api/music`

已停用上游音乐服务（MiniMax music-01）已停止对新用户开放，该通道暂不可用，恢复后另行通知。

🔀 模型路由（后台可切换）

通道	对外接口	默认模型	厂商
chat	/api/chat	DeepSeek-V4-Flash	DeepSeek
code	/api/code	DeepSeek-V4-Pro	DeepSeek
vision	/api/vision 识图	通义千问-VL-Max	阿里云
image	/api/vision 生图	豆包 Seedream-5.0	火山方舟
video	/api/video	通义万相（视频）	阿里云
voice	/api/voice	通义 qwen-tts	阿里云
asr	/api/asr	通义 paraformer-v2	阿里云
music	/api/music	—（已停用）	—

管理员可在 /admin 后台「渠道配置」中随时更换每个通道绑定的模型，无需改代码。

🔐 鉴权与错误码

请求需携带 Authorization: Bearer {API_KEY}，Key 由管理员在后台「客户端管理」中创建分配。错误统一返回：

{ "success": false, "error": "错误描述", "code": 400 }

HTTP 状态码	含义
200	成功（success: true）
400	参数缺失或格式错误
401	缺少 API Key 或格式错误
403	API Key 无效 / 已被停用
404	接口不存在
429	限流：每分钟次数 / 每日次数 / 月 Token / 总 Token 超限
500	上游模型调用失败（error 字段含具体原因）

📊 用量与限额

每个客户端独立限额：每分钟请求数、每日请求数、每月 Token、总 Token（后台可配）；
每次调用均记录日志与 Token 用量，可在后台「请求日志」查看；
语音合成音频转存本站 /assets/audio/；生图/视频返回的是厂商临时链接（约 24 小时有效），重要资源请及时下载保存。
限流重试：429 响应携带 Retry-After: 60 头，客户端应据此退避重试；
上传超时：/api/upload 建议客户端连接/读取超时 ≥30 秒。

AI API 中转站 · DeepSeek / 阿里云通义 / 火山方舟豆包 · 文档更新于 2026-08-24

⚡ AI API 中转站

📡 接口总览

💬 文本对话

🖼️ 识图生图

💻 代码生成

🎬 视频生成

🗣️ 语音合成

👂 语音识别

📤 音频上传

🎤 音色列表

🎵 音乐生成

📖 接口详情

1. 文本对话 /api/chat

2. 识图生图 /api/vision

3. 代码生成 /api/code

4. 视频生成 /api/video

5. 语音合成 /api/voice

6. 语音识别 /api/asr

7. 音频上传 /api/upload

8. 音色列表 /api/voices

9. 音乐生成 /api/music

🔀 模型路由（后台可切换）

🔐 鉴权与错误码

📊 用量与限额

1. 文本对话 `/api/chat`

2. 识图生图 `/api/vision`

3. 代码生成 `/api/code`

4. 视频生成 `/api/video`

5. 语音合成 `/api/voice`

6. 语音识别 `/api/asr`

7. 音频上传 `/api/upload`

8. 音色列表 `/api/voices`

9. 音乐生成 `/api/music`