• 简体中文
  • 接入地址与鉴权

    所有 API 通过统一网关地址访问。主流路径是 OpenAI 兼容协议 + Bearer 令牌鉴权;Anthropic / Gemini 原生端点作为扩展兼容,见下文。

    接入地址(BASE_URL)

    OpenAI 兼容端点如下:

    用途方法地址
    文本对话(对话、多轮、流式)POSThttps://api-model.shuntianchuang.cn/v1/chat/completions
    Responses(新式对话接口)POSThttps://api-model.shuntianchuang.cn/v1/responses
    模型列表GEThttps://api-model.shuntianchuang.cn/v1/models
    文本嵌入POSThttps://api-model.shuntianchuang.cn/v1/embeddings
    重排POSThttps://api-model.shuntianchuang.cn/v1/rerank
    图片生成POSThttps://api-model.shuntianchuang.cn/v1/images/generations
    图片编辑POSThttps://api-model.shuntianchuang.cn/v1/images/edits
    视频生成(提交)POSThttps://api-model.shuntianchuang.cn/v1/videos
    视频任务查询 / 下载GEThttps://api-model.shuntianchuang.cn/v1/videos/{task_id}(/content 下载视频)
    语音合成(TTS)POSThttps://api-model.shuntianchuang.cn/v1/audio/speech
    语音转文字(STT)POSThttps://api-model.shuntianchuang.cn/v1/audio/transcriptions
    TIP

    使用 OpenAI 官方 SDK 时,base_url 填 https://api-model.shuntianchuang.cn/v1(带 /v1,SDK 会自动拼接后续路径);直接发 HTTP 请求时使用上表完整地址。

    接入地址也可以在控制台「概览」页的 API 信息 卡片中查看和复制,该卡片同时提供「测试延迟」入口。

    鉴权方式

    不同协议端点使用不同的鉴权头,先分清自己调用的是哪种端点:

    端点鉴权头
    OpenAI 兼容端点(上表全部端点)Authorization: Bearer sk-你的令牌
    Anthropic 原生端点(/v1/messages)x-api-key: sk-你的令牌,另需 anthropic-version: 2023-06-01
    Gemini 原生端点(/v1beta/models/{model}:generateContent)x-goog-api-key: sk-你的令牌

    API Key 在控制台「API 密钥」页创建,详见 API Key 管理。OpenAI 兼容端点接口路径与请求 / 响应格式完全兼容 OpenAI 官方 API——SDK 只需把 base_url 换成本站地址、api_key 换成本站令牌,其余代码无需改动。三种常见设置方式:

    cURL
    Python (openai)
    Node.js (openai)
    # 每个请求都带 Authorization 头
    curl https://api-model.shuntianchuang.cn/v1/chat/completions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "deepseek-v4-flash",
        "messages": [{ "role": "user", "content": "你好" }]
      }'
    
    # 也可以存进变量复用
    export SHUNTIANCHUANG_API_KEY=sk-你的令牌
    curl https://api-model.shuntianchuang.cn/v1/chat/completions \
      -H "Authorization: Bearer $SHUNTIANCHUANG_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "model": "deepseek-v4-flash", "messages": [{ "role": "user", "content": "你好" }] }'

    扩展兼容:Anthropic / Gemini

    本站对部分模型同时开放 Anthropic 与 Gemini 原生端点,供对应官方 SDK 及客户端直接接入(鉴权头见上文 鉴权方式,各 SDK 示例中已带上):

    协议接入地址
    Anthropic 原生POST https://api-model.shuntianchuang.cn/v1/messages
    Gemini 原生POST https://api-model.shuntianchuang.cn/v1beta/models/{model}:generateContent
    NOTE

    仅部分模型支持多协议端点,支持列表见 模型说明。两种端点都要把模型名换成本站模型(如 glm-5.2),平台未上架 Anthropic / Google 官方模型名。

    Anthropic SDK

    base_url 填站点根地址(不带 /v1,SDK 自动拼接 /v1/messages),鉴权用 api_key(SDK 自动携带 x-api-key 与 anthropic-version 头):

    cURL
    Python (anthropic)
    Node.js (@anthropic-ai/sdk)
    curl https://api-model.shuntianchuang.cn/v1/messages \
      -H "x-api-key: sk-你的令牌" \
      -H "anthropic-version: 2023-06-01" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "glm-5.2",
        "max_tokens": 1024,
        "messages": [{ "role": "user", "content": "你好" }]
      }'

    Gemini SDK

    base_url 同样填站点根地址(不带 /v1beta,SDK 自动拼接后续路径),令牌通过 api_key 传入(对应 x-goog-api-key 头):

    cURL
    Python (google-genai)
    Node.js (@google/genai)
    # 模型名写在 URL 中,:generateContent 前是模型名
    curl -X POST "https://api-model.shuntianchuang.cn/v1beta/models/glm-5.2:generateContent" \
      -H "x-goog-api-key: sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "contents": [{ "role": "user", "parts": [{ "text": "你好" }] }]
      }'

    Claude Code、Codex 等客户端工具的完整配置教程见 客户端接入。

    常见鉴权问题

    现象原因
    401 Unauthorized令牌未携带、填错、含多余空格,或已被删除
    403 Forbidden令牌已被禁用,或令牌的模型范围 / IP 白名单限制了本次请求
    余额充足仍报额度不足令牌自身的额度上限已用尽或已过期

    完整错误码说明见 错误码对照与排查。第一次调用请从 快速开始 开始。