入门指南 ​

数分钟内了解 SCNet 模型服务的计费方式，并完成首次模型调用。

SCNet 模型服务目前提供两种计费方式：按量调用付费 和 TokenPlan 订阅。两种计费方式的扣费规则、API Key 类型和适用场景不同。开始使用前，请先确认您的使用方式：

  • 如果您需要在自研业务、服务端程序、脚本或自动化流程中直接调用模型 API，请选择 按量调用付费。
  • 如果您主要在支持的 AI 编程工具或智能体工具中长期使用模型能力，并希望按月控制预算，请选择 TokenPlan 订阅。

本文将先说明两种计费方式的区别，然后分别介绍 按量调用付费的使用流程 和 TokenPlan 的使用规则。

1. 计费方式说明 ​

对比项按量调用付费TokenPlan 订阅
计费方式定位面向直接调用模型 API 的通用计费方式面向固定预算和工具使用场景的包月订阅计费方式
计费方式按实际调用产生的用量扣费按月订阅，调用时从套餐 Credits 中抵扣
API Key 类型通用 API Key，通常以 sk- 开头TokenPlan 专属 API Key，通常以 sk-tp- 开头
使用方式通过 HTTP 请求调用 OpenAI 或 Anthropic 兼容接口将专属 API Key 配置到支持的 AI 编程或智能体工具中使用
适用场景自研业务、服务端集成、脚本调用、批处理、模型试用AI 编程工具、智能体工具、长期高频使用、固定预算控制
额度用尽后账户余额不足时调用失败Credits 用尽后调用失败，不会自动转为按量付费

重要提示

按量调用付费和 TokenPlan 订阅使用的 API Key 相互独立，不能混用。使用错误的 API Key 可能导致调用失败、TokenPlan 额度无法抵扣，或产生非预期费用。

2. 按量调用付费 ​

按量调用付费适合需要直接调用模型 API 的场景。您可以根据实际业务需求发起请求，平台会按照模型实际消耗的 Token 或调用量进行计费。

2.1 使用流程 ​

完成一次按量调用通常需要以下步骤：

  1. 创建 API Key
    前往 API Key 管理 页面，创建通用 API Key。通用 API Key 通常以 sk- 开头。

  2. 选择模型
    在 模型列表 中查看当前可用模型，记录需要调用的模型名称。您也可以通过 模型查询接口 获取模型信息。

  3. 选择接口协议
    SCNet 模型服务提供 OpenAI 兼容协议和 Anthropic 兼容协议。您可以根据现有业务的接口习惯选择对应协议。

  4. 发起 HTTP 请求
    在请求头中携带 API Key，并在请求体中填写模型名称、输入内容等参数。

  5. 查看结果和用量
    请求成功后，可从响应内容中获取模型输出，并根据返回的 usage 字段或控制台账单查看用量。

2.2 接入地址 ​

协议Base URL鉴权方式
OpenAI 兼容协议https://api.scnet.cn/api/llm/v1Authorization: Bearer <API Key>
Anthropic 兼容协议https://api.scnet.cn/api/llm/anthropicAuthorization: Bearer <API Key>

说明

OpenAI 兼容协议地址中的 /v1 仅表示接口版本，不代表模型版本。

2.3 OpenAI 兼容协议调用示例 ​

以下示例演示如何通过 HTTP 请求调用对话模型。请将 <API Key> 替换为您创建的通用 API Key，并将 model 替换为实际需要调用的模型名称。以下示例为非流式调用；如需流式输出，将 stream 设置为 true 即可。

shell
curl 'https://api.scnet.cn/api/llm/v1/chat/completions' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API Key>" \
  -d '{
        "model": "DeepSeek-R1-Distill-Qwen-7B",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'
go
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "strings"
)

func main() {
    url := "https://api.scnet.cn/api/llm/v1/chat/completions"
    method := "POST"

    payload := strings.NewReader(`{
  "messages": [
    {"content": "You are a helpful assistant.", "role": "system"},
    {"content": "Hello!", "role": "user"}
  ],
  "model": "DeepSeek-R1-Distill-Qwen-7B",
  "stream": false
}`)
    client := &http.Client{}
    req, err := http.NewRequest(method, url, payload)
    if err != nil {
        fmt.Println(err)
        return
    }
    req.Header.Add("Content-Type", "application/json")
    req.Header.Add("Authorization", "Bearer <API Key>")

    res, err := client.Do(req)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer res.Body.Close()

    body, err := ioutil.ReadAll(res.Body)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(body))
}

2.4 Anthropic 兼容协议调用示例 ​

以下示例演示如何通过 Anthropic 兼容协议发起模型请求。请将 <API Key> 替换为您创建的通用 API Key，并将 model 替换为实际需要调用的模型名称。

shell
curl https://api.scnet.cn/api/llm/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "Authorization: Bearer <API Key>" \
  -d '{
      "messages": [{"role": "user", "content": "你好"}],
      "model": "MiniMax-M2.5",
      "max_tokens": 1024,
      "stream": false
    }'

2.5 计费说明 ​

按量调用付费会根据实际使用量扣费。不同模型类型的计费方式可能不同，请以模型价格页和具体接口说明为准。

模型类型计费方式常见计费单位
大语言模型按 Token 后付费输入 Token、输出 Token；如支持缓存，还可能区分缓存命中输入 Token
向量模型按 Token 后付费输入 Token
OCR 模型按调用次数计费次、页或张

提示

用量和费用数据可能存在一定延迟。建议您定期在控制台查看账户余额、用量和账单明细。

3. TokenPlan 订阅 ​

TokenPlan 是面向固定预算和持续使用场景的包月订阅计费方式。订阅后，系统会为当前周期提供固定 Credits 额度，使用时按平台规则从 Credits 中抵扣。

TokenPlan 与按量调用付费的核心区别是：TokenPlan 使用套餐 Credits 控制月度预算，且必须使用 TokenPlan 专属 API Key；按量调用付费则根据实际调用量从账户余额中扣费。

3.1 使用流程 ​

  1. 订阅套餐
    登录控制台，进入模型服务的 TokenPlan 页面，选择所需套餐并完成订阅。

  2. 获取专属 API Key
    订阅成功后，在 TokenPlan 相关页面查看套餐状态、Credits 用量、专属 API Key 和可用 Base URL。TokenPlan 专属 API Key 通常以 sk-tp- 开头。

  3. 配置到工具中使用
    将 TokenPlan 专属 API Key 和 Base URL 配置到支持的 AI 编程或智能体工具中。

  4. 查看额度消耗
    在 TokenPlan 页面查看本周期 Credits 消耗、剩余额度和额度重置时间。

3.2 使用规则 ​

使用 TokenPlan 时，请遵循以下规则：

  • TokenPlan 必须使用专属 API Key，通常以 sk-tp- 开头。
  • TokenPlan 专属 API Key 与按量调用付费的通用 API Key 不互通，不能混用。
  • TokenPlan 适用于支持的 AI 编程或智能体工具配置使用。
  • 如需用于自研业务、服务端集成、脚本调用或批量自动化调用，请使用按量调用付费。
  • 调用时会优先从当前订阅周期的 Credits 额度中抵扣。
  • Credits 用尽后，继续调用会失败，不会自动切换为按量调用付费。
  • 到期未使用完的 Credits 不支持结转到下一周期。
  • 套餐有效期、续费规则、配额限制和可用模型范围，请以 TokenPlan 页面展示为准。

3.3 套餐与额度 ​

TokenPlan 通常按月订阅。不同套餐提供的 Credits 额度不同，适用场景也不同。请在订阅前根据使用频率、模型类型和预算选择合适套餐。

规则说明
订阅周期通常按月计算，自购买成功后生效
额度抵扣调用模型产生的用量会按平台规则折算为 Credits 后扣减
额度用尽本周期 Credits 用尽后调用失败
额度结转到期未使用完的 Credits 不支持结转
API Key每个 TokenPlan 订阅使用专属 API Key

3.4 适用场景 ​

TokenPlan 更适合以下场景：

  • 希望每月固定预算；
  • 高频使用 AI 编程工具；
  • 需要在多个支持工具中持续使用模型能力；
  • 希望通过套餐额度控制总体成本。

4. 如何选择 ​

使用需求建议选择
想先试用模型 API按量调用付费
需要接入自研系统或服务端程序按量调用付费
需要脚本、批处理或自动化调用按量调用付费
主要用于 AI 编程工具或智能体工具TokenPlan 订阅
希望按月控制预算TokenPlan 订阅
不确定使用量大小先使用按量调用付费，再根据稳定用量选择 TokenPlan

5. 下一步 ​

完成计费方式选择后，您可以继续阅读以下文档：