Appearance
API 概览
所有接口均使用 HTTPS，并通过 Authorization: Bearer <API_KEY> 鉴权。根地址为 https://api.furry.vg。
已记录端点
| 用途 | 方法与路径 | Base URL | 说明 |
|---|---|---|---|
| 查询模型 | GET /v1/models | https://api.furry.vg | 返回当前 API Key 可用的模型列表。 |
| 语言模型对话 | POST /v1/chat/completions | https://api.furry.vg | OpenAI Chat Completions 兼容接口。 |
| Jev 决策模型 | POST /v1/systemone | https://api.furry.vg | TypeSafe System One 专用接口，使用 state + questions 请求体。 |
| 文本转语音 | POST /v1/audio/speech | https://api.furry.vg | 使用 azure-tts、unreal-speech-v8 或 indextts-2 同步返回音频。 |
| 提交异步语音任务 | POST /v1/audio/speech/tasks | https://api.furry.vg | 提交 UnrealSpeech 或 IndexTTS2 语音任务，文本限制按模型区分。 |
| 查询异步语音任务 | GET /v1/audio/speech/tasks/{task_id} | https://api.furry.vg | 查询语音任务状态和网关内容地址。 |
| 下载异步语音 | GET /v1/audio/speech/tasks/{task_id}/content | https://api.furry.vg | 通过网关代理下载任务音频。 |
| 下载语音时间戳 | GET /v1/audio/speech/tasks/{task_id}/timestamps | https://api.furry.vg | 通过网关代理下载词级或句级时间戳 JSON。 |
| WebSocket 语音流 | GET /v1/audio/speech/websocket?model=unreal-speech-v8 | wss://api.furry.vg | 转发 UnrealSpeech 音频分块和时间戳帧。 |
| 提交 3D 任务 | POST /v1/3d | https://api.furry.vg | 创建文生 3D、图生 3D 或 texture 任务。 |
| 查询 3D 任务 | GET /v1/3d/{task_id} | https://api.furry.vg | 读取异步任务状态与完成结果。 |
| 提交视频任务 | POST /v1/videos | https://api.furry.vg | 使用 minimax-h3 生成视频，自动选择文本、图片或图加音频工作流。 |
| 查询视频任务 | GET /v1/videos/{id} | https://api.furry.vg | 查询视频生成状态。 |
| 下载视频 | GET /v1/videos/{id}/content | https://api.furry.vg | 通过网关代理下载 MP4，支持 HEAD 和 Range。 |
语言模型接口见语言模型 API，Jev 决策模型见Jev / System One API，模型 ID 的获取方式见查询模型列表。文本转语音见Speech API，参考音频克隆和情绪控制见IndexTTS2 API。视频输入、分辨率计费和代理下载见MiniMax H3 视频生成。3D 接口的完整字段、状态流转和下载流程见3D 生成 API。
请求约定
http
Authorization: Bearer sk-your-s3ai-key
Content-Type: application/json- 请求体使用 UTF-8 JSON。
- 同步 Speech API 和异步语音内容接口成功时直接返回音频二进制内容，客户端需要将响应保存为文件。
- 成功创建的异步任务会返回外层
id或task_id，用于后续轮询。 - 异步语音任务的
status为completed后，通过content_url下载结果；failed表示任务未成功完成。 - HTTP 错误的处理建议见错误码。
协议兼容性
OPENAI_BASE_URL 的默认值为 https://api.furry.vg/v1。普通语言模型可使用 OpenAI Chat Completions 兼容接口，文本转语音可使用 OpenAI Speech 兼容接口。Jev 属于 TypeSafe 决策模型，只能调用 /v1/systemone，不能使用 Chat Completions 的 messages 格式。不同账户能访问的模型、上下文长度、视觉、工具调用和流式输出能力以 GET /v1/models 的实际返回以及服务端策略为准。
Responses 与 Anthropic Messages 是否可用，取决于网关当前对账户和模型开放的能力；在有明确端点与请求示例前，请不要假设这些协议可用。