Zhiyuan

致远一号

项	值
平台	models.sjtu.edu.cn
认证	API Key（Bearer）
数据方向	只读推理（chat/completions）
难度	低
最后验证	2026-10-25
证据等级	B（官方文档；未在本机实测）

致远一号是网络信息中心提供的校内大模型 API。它兼容 OpenAI 和 Anthropic 两种请求格式，适合把校园数据接进本地 Agent、做课程问答、摘要、翻译等。

要点

• 可获取：模型列表、文本或多模态生成结果、用量和额度。
• 前置：在交我办申请 API Key；校园网或 VPN。
• Base URL：https://models.sjtu.edu.cn/api/v1
• 注意：模型名要使用 /models 返回的 id，不要使用申请表里的名称；校外访问必须连接 VPN；额度和测试期限会变化。

---

1. 数据清单

能力	端点	说明
模型列表	GET /models	用返回的 id 作为调用名
文本对话	POST /chat/completions	OpenAI 兼容
深度推理	POST /chat/completions	deepseek-reasoner，返回 reasoning_content
图像理解	POST /chat/completions	qwen 支持 image_url（base64/data URL）
Anthropic 格式	POST /messages	与 OpenAI 格式功能等价
用量查询	https://aic.sjtu.edu.cn/top	用 API Key 登录查近 30 天

模型（2026-03-24 官方文档）：

模型	调用名	模式	上下文
DeepSeek V4 Flash（常规）	deepseek-chat	非思考	512k
DeepSeek V4 Flash（思考）	deepseek-reasoner	深度思考	512k
Qwen3.8-27B	qwen 或 qwen3.8-27b	多模态	256k

Note

模型和额度会变。每次以 GET /models 和交我办申请页为准，不要把上表当永久清单。

---

2. 申请

1. 登录 my.sjtu.edu.cn 或交我办 App。
2. 搜索「“致远一号”AI模型API申请（测试）」。
3. 填用途、场景、接收开通信息的邮箱。
4. 提交后等待审批。
5. 通过后，邮箱/交我办消息会收到 base_url 和 api-key。

默认配额（2026-03-24 文档，仅作参考）：

• 每分钟请求数：10
• 每分钟 token：300,000
• 每周 token 总量：1,000,000,000
• token 有效期：截止到 2026-12-31（测试结束）

这些数字会变；以申请页/开通邮件为准。

---

3. 调用

列模型

curl 'https://models.sjtu.edu.cn/api/v1/models' \
  -H "Authorization: Bearer $SJTU_MODEL_KEY"

返回：

{
  "data": [
    { "id": "qwen", "object": "model", "owned_by": "openai" },
    { "id": "deepseek-chat", "object": "model", "owned_by": "openai" },
    { "id": "deepseek-reasoner", "object": "model", "owned_by": "openai" }
  ],
  "object": "list"
}

文本对话（OpenAI 兼容）

curl -X POST 'https://models.sjtu.edu.cn/api/v1/chat/completions' \
  -H "Authorization: Bearer $SJTU_MODEL_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      { "role": "system", "content": "你是上海交大的课程助手。" },
      { "role": "user", "content": "用三句话解释什么是进程。" }
    ],
    "stream": false,
    "max_tokens": 512
  }'

图像理解

{
  "model": "qwen",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "image_url", "image_url": { "url": "data:image/png;base64,..." } },
        { "type": "text", "text": "解释这张课件截图。" }
      ]
    }
  ],
  "stream": false
}

Anthropic 格式

curl -X POST 'https://models.sjtu.edu.cn/api/v1/messages' \
  -H "Authorization: Bearer $SJTU_MODEL_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "deepseek-chat",
    "max_tokens": 512,
    "messages": [{ "role": "user", "content": "你好" }]
  }'

---

4. 常见问题

1. 校外必须 VPN：平台仅限校园网访问；校外直连会超时/拒绝。[官方]
2. 模型名使用 /models 返回的 id：申请表单中的名称不能用作调用名；qwen3.8-27b 和 qwen 可能是同一个模型的不同别名。[官方]
3. 不要泄露 API Key：泄露会被别人消耗额度；不要写进前端、Git、日志。
4. 额度会变：RPM/TPM/每周总量/有效期都以申请页为准；不要硬编码。
5. OpenAI 兼容不等于全兼容：stream、max_tokens、多模态字段按官方示例；不要假设 tools/function_call/response_format 都支持。
6. Anthropic 格式只是端点不同：消息体结构保持官方示例；不要混用 OpenAI 的字段名。
7. 长上下文有成本：512k 上下文不等于免费；长文档先切分/检索，再送模型。
8. 429/限流：按 Retry-After 或指数退避；不要并发轰炸。
9. 模型输出可能错：ASR/OCR/摘要都可能出错；展示时标来源，提供回到原文的链接。

---

5. 组合示例：校园数据 + 模型

这是数据流示例，不是致远一号自带能力；具体实现应放进场景食谱（Recipe-Campus-AI，待写）。

推荐的数据流：

Canvas / 邮件 / 水源 / 课堂视频
  → 本地索引（SQLite/文件）
  → 按问题检索最小片段
  → 送致远一号
  → 回答里附来源（课程/邮件/帖子/视频时间戳）

不要：

• 把整个邮箱/整个课程打包进 prompt。
• 把 Token、Cookie、学号、成绩流水发给模型。
• 让模型「记住」私密数据；默认不写长期记忆。
• 把模型输出直接当成事实；引用原文。

---

6. 证据与来源

• Base URL、模型、端点、配额、校园网限制、用量查询：[官方 2026-10-25，claw.sjtu.edu.cn/guide/sjtu-api/]
• OpenAI/Anthropic 兼容格式、模型别名：[官方]
• Dela 的 provider 预设：[代码] src/shared/llm-presets.ts（baseUrl: https://models.sjtu.edu.cn/api/v1）

变更记录

• 2026-10-25：首版。基于官方文档与 Dela provider 预设；未做本机实测，标 B 级。