跳到主要内容

API代码调用

  • 校内师生可通过代码使用API KEY调用AIGC API服务
  • AIGC提供的大模型列表请查看: 模型列表

API端点​

  • AIGC当前提供V1和V2两个版本API端点，2026年9月4日后，V1版本API请求自动转发到V2版本，实现请求的统一调度与响应。
  • AIGC统一通过LiteLLM Proxy服务将请求转发到后端大模型
API 版本API 端点API 协议格式API请求参数(LiteLLM)
V2- https://aigc-api.hkust-gz.edu.cn/api/v2/chat/completions
- https://aigc-api.hkust-gz.edu.cn/api/v2/embeddings		OPENAIlitellm-completion input parameters
V1- https://aigc-api.hkust-gz.edu.cn/v1/chat/completions
- https://aigc-api.hkust-gz.edu.cn/v1/embeddings		OPENAIlitellm-embedding input parameters

API鉴权​

平台API采用Bearer Token方式进行鉴权。所有请求需在HTTP Header中携带API Key。

Header格式

Authorization: Bearer your_api_key
Content-Type: application/json

安全建议

  • 请勿在代码中硬编码API Key
  • 建议通过环境变量或密钥管理服务读取密钥

调用示例​

CURL：对话补全​

curl -X POST https://aigc-api.hkust-gz.edu.cn/api/v2/chat/completions \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "DeepSeek-V4-Pro",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "请介绍一下自己"}
    ],
  }'

Python：对话补全​

import os
import requests

API_KEY = os.getenv("AIGC_API_KEY")
url = "https://aigc-api.hkust-gz.edu.cn/api/v2/chat/completions"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "model": "DeepSeek-V4-Pro",
    "messages": [
        {"role": "system", "content": "你是一个有用的助手"},
        {"role": "user", "content": "请介绍一下自己"}
    ],
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())