• 简体中文
  • 快速开始:发起第一次调用

    本页带你从零跑通第一次 API 调用。示例使用模型 deepseek-v4-flash(default 分组,按量计费,输入 ¥1 / 输出 ¥2 每百万 token,是本站最经济的对话模型之一)。

    前置条件

    开始之前,请确认以下三项已就绪:

    1. 已注册账号——还没有账号请先完成 注册与登录
    2. 账户已充值——余额不足会调用失败,充值方式见 充值与计费
    3. 已创建 API Key——需要一个以 sk- 开头的令牌,创建方法见 API Key 管理

    发起调用

    以下三个示例逻辑完全一致:向 deepseek-v4-flash 提问「你是谁?请用一句话介绍你自己。」,任选一种语言运行即可。

    cURL
    Python (openai)
    Node.js (openai)
    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": "你是谁?请用一句话介绍你自己。" }
        ]
      }'
    NOTE

    本站兼容 OpenAI SDK。使用官方 SDK 时,只需把 base_url 换成 https://api-model.shuntianchuang.cn/v1,api_key 换成你的令牌,其余代码不用改。

    预期返回

    调用成功时,返回标准 OpenAI 格式的 JSON:

    {
      "id": "chatcmpl-xxxxxxxx",
      "object": "chat.completion",
      "created": 1760000000,
      "model": "deepseek-v4-flash",
      "choices": [
        {
          "index": 0,
          "message": {
            "role": "assistant",
            "content": "我是一个 AI 助手……"
          },
          "finish_reason": "stop"
        }
      ],
      "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 30,
        "total_tokens": 42
      }
    }

    其中 choices[0].message.content 是模型的回答,usage 是本次消耗的 token 数量(计费依据)。

    常见的第一次失败

    现象原因解决办法
    返回 401 Unauthorized令牌填错、多了空格,或未携带 Authorization 头核对令牌后重试,见 API Key 管理
    返回「余额不足 / insufficient quota」账户余额为 0 或令牌额度用尽先 充值,或检查令牌额度设置
    返回 model not found模型名拼写错误或该模型不在你的分组到 模型广场 复制准确模型名
    连接超时网络环境限制检查本地网络或代理设置

    完整的错误码说明见 错误码对照与排查。

    下一步