🔑 TokenRelay

加载中...

当前系统中所有可用的大语言模型，可通过 API 直接调用。

1. 概述

本服务是基于火山引擎 Coding Plan Pro 构建的大模型 API 代理转发平台，作为 Coding Plan 的下游服务，为您提供兼容 OpenAI 格式的 Chat Completions 接口。

您可以使用任何支持 OpenAI API 的客户端或 SDK 直接接入，无需修改代码。所有请求由 Coding Plan 上游处理，本系统负责鉴权、配额管理和请求转发。

当前支持的接口类型：对话补全（Chat Completions）。

2. 快速开始

2.1 获取 API 密钥

在左侧导航「密钥管理」页面点击「创建密钥」，生成一个以 sk-tr- 开头的 API 密钥。

密钥创建后仅展示一次，请妥善保存。每个用户最多创建 5 个密钥，可按项目或环境分别管理。

2.2 配置连接信息

将您的客户端配置为以下连接信息：

3. 鉴权方式

本系统使用 Bearer Token 鉴权，与 OpenAI 完全兼容：

Authorization: Bearer sk-tr-xxxxxxxxxxxxxxxxxxxxxxxx

请求头中的 API Key 对应您在「密钥管理」页面创建的密钥。

也支持在请求 URL 中传递参数：?api_key=sk-tr-xxxxxxxx

4. API 端点

本服务仅提供对话补全接口，路径与 OpenAI API 一致：

请求参数

响应格式

响应格式与 OpenAI Chat Completions 兼容：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "ark-code-latest",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "回复内容"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

流式模式下，每个 chunk 的 choices[0].delta 包含增量内容，最终 chunk 的 finish_reason 为 "stop"。

5. 代码示例

5.1 Python（OpenAI SDK）

from openai import OpenAI

BASE_URL = "这里会自动填充"

client = OpenAI(
    api_key="sk-tr-your-key-here",
    base_url=BASE_URL
)

# 非流式请求
response = client.chat.completions.create(
    model="ark-code-latest",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

# 流式请求
stream = client.chat.completions.create(
    model="ark-code-latest",
    messages=[{"role": "user", "content": "写一段冒泡排序"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

5.2 cURL

curl http://.../v1/chat/completions \
  -H "Authorization: Bearer sk-tr-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ark-code-latest",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# 流式模式
curl http://.../v1/chat/completions \
  -H "Authorization: Bearer sk-tr-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ark-code-latest",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

5.3 Node.js（OpenAI SDK）

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-tr-your-key-here',
  baseURL: 'http://.../v1',
});

// 非流式
const response = await client.chat.completions.create({
  model: 'ark-code-latest',
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);

// 流式
const stream = await client.chat.completions.create({
  model: 'ark-code-latest',
  messages: [{ role: 'user', content: 'Hello!' }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

5.4 Python 原生 requests

import requests
import json

url = "http://.../v1/chat/completions"
headers = {
    "Authorization": "Bearer sk-tr-your-key-here",
    "Content-Type": "application/json"
}
data = {
    "model": "ark-code-latest",
    "messages": [{"role": "user", "content": "Hello!"}]
}

resp = requests.post(url, headers=headers, json=data)
print(resp.json()["choices"][0]["message"]["content"])

6. 可用模型

在左侧导航「可用模型」页面可以查看当前所有可用的模型列表。

也可通过 API 获取：

curl http://.../v1/models \
  -H "Authorization: Bearer sk-tr-your-key-here"

返回格式与 OpenAI 兼容：{"data": [{"id": "model-name", "object": "model"}, ...]}

7. 调用限制说明

本系统作为 Coding Plan 的下游服务，按照调用次数（而非 token 消耗）对用户进行配额管理。每个用户设有三个独立周期的调用上限，任一周期用完即返回 HTTP 429 错误：

各周期调用量相互独立计算，任一周期用完即停止服务直到重置。

8. 错误码说明

9. 常见问题