RonFin TokenHub Channel

Customer Guide

TokenHub API Key usage guide

Use the RonFin sk_rf_* customer key to call large model APIs through the OpenAI-compatible TokenHub channel.

1. 接入信息

请向镕峰数字获取以下信息。客户只使用镕峰数字分配的 sk_rf_*，腾讯云侧供应商 Key 不会提供给客户。

项目	说明	示例
Base URL	镕峰数字统一 API 入口	`https://ronfin.top/api/v1`
API Key	您的客户专属密钥	`sk_rf_xxxxxxxxx`
可用模型	您账号允许调用的模型列表	`deepseek-v3.1`
月度限额	本客户每月可消费金额上限	5000 RMB

2. 快速验证

cURL

curl https://ronfin.top/api/v1/chat/completions \
  -H "Authorization: Bearer sk_rf_your_customer_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3.1",
    "messages": [
      { "role": "user", "content": "只回复 pong" }
    ],
    "temperature": 0.1,
    "max_tokens": 8
  }'

Success response

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "model": "deepseek-v3.1-terminus",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "pong"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 11,
    "completion_tokens": 3,
    "total_tokens": 14
  }
}

3. OpenAI SDK 配置

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.RF_API_KEY,
  baseURL: "https://ronfin.top/api/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-v3.1",
  messages: [{ role: "user", content: "只回复 pong" }],
  temperature: 0.1,
  max_tokens: 8,
});

console.log(completion.choices[0]?.message?.content);

Python

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["RF_API_KEY"],
    base_url="https://ronfin.top/api/v1",
)

completion = client.chat.completions.create(
    model="deepseek-v3.1",
    messages=[{"role": "user", "content": "只回复 pong"}],
    temperature=0.1,
    max_tokens=8,
)

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

4. 模型名称

客户侧请求使用镕峰数字公开模型名。镕峰数字会在服务端自动映射到腾讯云 TokenHub 的实际服务 ID。

客户侧模型名	说明
`deepseek-v3.1`	DeepSeek V3.1 文本对话模型
`deepseek-v3.2`	DeepSeek V3.2 文本对话模型

5. 计费和限额

每次调用会根据上游返回的 usage 记录输入 token、输出 token 和缓存命中 token。

客户应收 = 腾讯云模型标价成本 x 镕峰渠道折扣 x 客户加价系数

您的账号会配置月度人民币限额。超过限额后，请求会被拒绝并返回 402 monthly_limit_exceeded。

6. 常见错误

HTTP 状态	错误码	处理方式
400	unsupported_model	模型名不存在或暂不支持，请检查 model 字段
400	model_not_allowed	当前客户未开通该模型，请联系镕峰数字开白
401	invalid_customer_key	API Key 错误、过期或已停用
402	monthly_limit_exceeded	月度限额已用完，请联系镕峰数字调额
503	supplier_not_configured	镕峰数字供应商配置异常，请联系技术支持
503	upstream_request_failed	腾讯云 TokenHub 请求失败，可稍后重试或联系支持

7. 安全建议

不要把 sk_rf_* 写进前端代码、App 包或公开仓库。
服务端通过环境变量读取 API Key，例如 RF_API_KEY。
按环境拆分密钥，例如测试、生产分别使用不同 API Key。
如怀疑密钥泄露，请立即联系镕峰数字停用并重新签发。

8. 技术支持需要的信息

请求时间，精确到分钟。
使用的客户侧模型名。
HTTP 状态码和错误码。
响应头中的 x-request-id 或响应体中的 request_id。
不要发送完整 API Key，只提供前 8 位和后 4 位即可。