API 使用

大模型公共服务平台提供标准化 API 调用能力，支持用户通过程序方式接入平台模型服务。平台兼容 OpenAI API 调用格式，开发者可使用 curl、Python、JavaScript 或各类 AI 应用框架快速调用模型。

基础地址

API 调用基础地址为：

https://api.llm.ustc.edu.cn/v1

如平台页面显示的地址与本文不同，请以平台页面为准。

鉴权方式

调用 API 时，需要在请求头中携带 API Key。

Authorization: Bearer sk-你的APIKey

完整请求头示例：

-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json"

查看模型列表

用于查询当前 API Key 可调用的模型。

curl https://api.llm.ustc.edu.cn/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

返回结果中会包含可用模型名称。调用模型时，请将模型名称填写到 model 字段中。

对话接口

对话接口用于文本生成、智能问答、代码辅助、文档总结等任务。

接口地址：

POST /v1/chat/completions

完整地址：

https://api.llm.ustc.edu.cn/v1/chat/completions

curl 调用示例

curl https://api.llm.ustc.edu.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "user",
        "content": "请用三句话介绍大语言模型。"
      }
    ],
    "temperature": 0.3
  }'

Python 调用示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://api.llm.ustc.edu.cn/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "请介绍一下 AI4Science 的主要应用。"}
    ],
    temperature=0.3
)

print(response.choices[0].message.content)

流式输出

对于较长回答，建议开启流式输出。流式输出可以边生成边返回内容，适合网页聊天、智能体和长文本生成场景。

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://api.llm.ustc.edu.cn/v1"
)

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "请详细介绍大语言模型在科研中的应用。"}
    ],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="")

常用参数

参数	说明	示例
`model`	模型名称	`deepseek-v4-flash`
`messages`	对话消息列表	`[{"role":"user","content":"你好"}]`
`temperature`	控制输出随机性	`0.3`
`max_tokens`	最大输出长度	`1024`
`stream`	是否流式输出	`true`

messages 格式说明

messages 用于组织对话内容。

[
  {
    "role": "system",
    "content": "你是一个严谨、简洁的科研助手。"
  },
  {
    "role": "user",
    "content": "请解释什么是大语言模型。"
  }
]

常见角色：

role	说明
system	系统指令，用于设定模型回答风格
user	用户输入
assistant	模型历史回复

最小可用测试

如果只是验证 API Key 是否可用，可以使用以下命令：

curl https://api.llm.ustc.edu.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

正常情况下，接口会返回模型生成的回复内容。

常见错误

状态码	常见原因	处理方式
401	API Key 错误或失效	检查 Key 是否正确
403	无模型调用权限	检查项目权限或模型授权
404	请求地址错误	检查 Base URL 和接口路径
429	请求过多或超过额度	降低并发或检查配额
500	服务端异常	稍后重试或联系技术支持

使用建议

API Key 应保存在服务端，不要写入前端页面
不同项目建议使用不同 API Key
高并发调用时建议增加重试和限流机制
长文本任务建议开启 stream
复杂任务建议降低 temperature，提高回答稳定性
重要科研结论需人工复核