# 维桢科技算力运营平台

> OpenAI 兼容算力网关。用 API Key（sk-relay-*）调用 /v1；下文含 API 说明、模型清单与计价口径。

鉴权：Authorization: Bearer sk-relay-...
Base URL：https://token.youtaihua.com/v1
门户：https://token.weizhenkeji.cn

---

## API 说明

OpenAI 兼容北向网关。本文档供 Agent / 脚本直接读取，无需渲染门户 SPA。

## 概述

- 门户：https://token.weizhenkeji.cn
- Base URL：`https://token.youtaihua.com/v1`
- 鉴权：`Authorization: Bearer sk-relay-<your-key>`
- 模型 id 清单：见同文档「模型清单」章节（租户公开目录，不含用户 ACL）

## 鉴权

所有北向请求须携带 Header：

```
Authorization: Bearer sk-relay-xxxxxxxx
Content-Type: application/json
```

API Key 在门户「密钥管理」创建；请勿将真实 Key 写入仓库或公开文档。

## Base URL

```
https://token.youtaihua.com/v1
```

北向调用以部署配置的 Base URL 为准（可能与访问门户的 Host 不同）。

## 端点

| 模态 | 方法 | 路径 |
|------|------|------|
| 模型目录 | GET | `/v1/models` |
| Chat | POST | `/v1/chat/completions` |
| Text | POST | `/v1/completions` |
| Image | POST | `/v1/images/generations` |
| Video | POST | `/v1/videos/generations` |
| Embedding | POST | `/v1/embeddings` |
| Rerank | POST | `/v1/rerank` |
| Audio | POST | `/v1/audio/transcriptions` |
| 异步任务 | GET | `/v1/tasks/{task_id}` |

`GET /v1/models` 须 API Key，返回 OpenAI 兼容 `{ object: "list", data: [{ id }] }`（无 modality 等扩展字段）；列表受用户模型白名单约束，可能比 models.md 更短。

## 流式（SSE）

Chat 等接口支持 `stream: true`，响应为 `text/event-stream`。

## 异步任务

部分图/视频模型返回 `task_id`，请轮询 `GET https://token.youtaihua.com/v1/tasks/{task_id}` 直至完成。

## OpenAI SDK 示例

```python
from openai import OpenAI

client = OpenAI(
    api_key="sk-relay-xxxxxxxx",
    base_url="https://token.youtaihua.com/v1",
)
resp = client.chat.completions.create(
    model="<model-id>",
    messages=[{"role": "user", "content": "Hello"}],
)
```

## 参数与选模

- 无 Key 浏览公开目录：见 `/models.md`（或 llms-full.txt 内「模型清单」）。
- 带 Key 编程/SDK：`GET /v1/models` 列出当前 Key 可调用的 model id。
- 各模型北向参数见模型详情页，或 `GET /app-api/relay/model/detail?modelId=` 的 `experience.apiDocParams`（与网关 inputSchema 同源）。
- 已安装 CLI / 配置 WorkBuddy 连接器的用户：MCP `list_models`（含模态）→ `get_model_schema` → `generate_*`（见 [https://token.weizhenkeji.cn/docs#clients](https://token.weizhenkeji.cn/docs#clients)）。

## Agent / WorkBuddy 接入

1. 安装 Relay CLI：[https://token.weizhenkeji.cn/cli/youtaihua-relay-latest.tgz](https://token.weizhenkeji.cn/cli/youtaihua-relay-latest.tgz) 或 [https://token.weizhenkeji.cn/docs#clients](https://token.weizhenkeji.cn/docs#clients)。
2. 运行 `relay setup workbuddy` 写入 MCP 配置。
3. chat 由 `models.json` 直连（可用 `GET /v1/models` 或 `model/page?modality=chat` 选模）；生图/生视频用 MCP：`list_models` → `get_model_schema` → `generate_image` / `generate_video` → `get_task`。

## 错误形态

失败时返回 JSON，常见字段：`error.message`、`error.type`、`error.code`（与 OpenAI 风格兼容）。



---

## 模型清单

> 数据更新于 2026-09-02 13:24（UTC+8）。与匿名广场同源。

| modelId | 展示名 | 模态 | 厂商 | 价格 |
|---------|--------|------|------|------|
| `deepseek-v4-pro-cm` | DeepSeek V4 Pro(移动) | chat | 移动物联网卡 | 入 2.85 元/百万 Token；出 5.7 元/百万 Token |
| `deepseek-v4-pro-0813-wzkj` | DeepSeek-V4-Pro-0813 | chat | 百炼 DashScope 维桢 | 入 9 元/百万 Token；出 27 元/百万 Token |
| `qwen3.8-max-bl` | Qwen3.8-Max(百炼) | chat | 百炼 DashScope | 入 12 元/百万 Token；出 36 元/百万 Token |
| `glm-5.2` | 智谱 GLM-5.2(移动) | chat | 移动物联网卡 | 入 7.6 元/百万 Token；出 26.6 元/百万 Token |
| `deepseek-v4-flash` | DeepSeek V4 Flash(移动) | chat | 移动物联网卡 | 入 0.95 元/百万 Token；出 1.9 元/百万 Token |
| `deepseek-v3.1` | DeepSeek V3.1 (移动) | chat | 移动物联网卡 | 入 3.8 元/百万 Token；出 11.4 元/百万 Token |
| `glm-5.1` | 智谱 GLM-5.1（移动） | chat | 移动物联网卡 | 0~31.999K 入5.7出22.8；32K~∞ 入7.6出26.6 元/百万 Token |
| `doubao-seed-1.6` | 豆包 Seed 1.6（移动） | chat | 移动物联网卡 | 0~32K 入0.76出0~200K@1.9,200.001K~∞@7.6；32.001K~128K 入1.14出15.2；128.001K~256K 入2.28出22.8 元/百万 Token |
| `doubao-seed-1.6-flash` | 豆包 Seed 1.6 Flash（移动） | chat | 移动物联网卡 | 0~32K 入0.1425出1.425；32.001K~128K 入0.285出2.85；128.001K~256K 入0.57出5.7 元/百万 Token |
| `doubao-seedream-4.0` | 豆包 Seedream 4.0-T2I（移动） | image | 移动物联网卡 | 0.19 元/张 |
| `doubao-seedream-4.0-i2i` | 豆包 Seedream 4.0-I2I（移动) | image | 移动物联网卡 | 0.19 元/张 |
| `doubao-seedream-4.5` | 豆包 Seedream 4.5（移动） | image | 移动物联网卡 | 0.2375 元/张 |
| `doubao-seedream-4.5-i2i` | 豆包 Seedream 4.5（移动)-I2I | image | 移动物联网卡 | 0.2375 元/张 |
| `Wan-AIWan2.6-T2V` | 万相 Wan2.6 文生视频（移动） | video | 移动物联网卡 | 720P 0.57 / 1080P 0.95 元/秒 |
| `Wan-AIWan2.6-I2V` | 万相 Wan2.6 图生视频（移动） | video | 移动物联网卡 | 720P 0.57 / 1080P 0.95 元/秒 |
| `Wan-AIWan2.6-R2V` | 万相 Wan2.6 参考生视频（移动） | video | 移动物联网卡 | 720P 0.57 / 1080P 0.95 元/秒 |

所有 chat/text 模型统一走 `POST https://token.youtaihua.com/v1/chat/completions`。

实际可调用集合以 API Key + 用户模型白名单为准；本页为租户公开目录。


---

## 计价口径

> **对外一律人民币元**（与门户一致）。纳元只是结费/余额内部精度，不用于报价与文档展示。

## 报价来源

各模型价格见同文档「模型清单」表格「价格」列（含图/视频规格档与 Token 输入分段）。

- 租户公开售价（已含模型默认倍率），单位均为 **元**。
- Token：元 / 百万 Token（入 / 出）
- 图片：元 / 张；视频：元 / 秒
- 有规格档或 Token 输入分段时，models.md「价格」列已并列写出各档元价（如 `720P 0.57 / 1080P 0.95 元/秒`）

## 计价单位（元）

| 模态 | 展示单位 |
|------|----------|
| chat / text / embedding / rerank | 元 / 百万 Token |
| image | 元 / 张 |
| video | 元 / 秒 |

Agent / 人类交叉验证：以 [models.md](https://token.weizhenkeji.cn/models.md) 元价为准，勿自行用 API 整数字段反推后改写报价。

## 内部精度（非展示）

平台结费、余额、流水使用纳元整数（1 元 = 10⁹ 纳元），避免浮点误差。**门户、models.md、pricing.md、账单给人看的金额均为元**；对接方若读取 API 整数字段，须先换算为元再展示，规则见外部对接手册。