SiCore TokenWorks

Документация API

Подробные руководства по подключению и справочник API помогут вам быстро интегрировать сервис SiCore TokenWorks AI API

1Быстрый старт

Для использования SiCore TokenWorks API достаточно трёх простых шагов:

  1. Зарегистрируйте аккаунт SiCore TokenWorks и войдите в консоль
  2. Создайте API Key в консоли
  3. Используйте ваш API Key для вызова наших интерфейсов

Tip: Новые пользователи после регистрации получат бесплатный пробный лимит, для начала использования не требуется привязка кредитной карты.

2Адрес интерфейса

Базовый адрес API указан ниже, все запросы используют протокол HTTPS:

text
https://www.token8341.com/v1

Интерфейс дополнения чата:

text
POST https://www.token8341.com/v1/chat/completions

Note: Этот интерфейс полностью совместим с форматом Chat Completions от OpenAI, вы можете напрямую использовать SDK от OpenAI для вызова.

3Способ аутентификации

SiCore TokenWorks использует Bearer Token для аутентификации API. Пожалуйста, укажите ваш API Key в заголовке запроса:

text
Authorization: Bearer sk-your-api-key-here

Вы можете создавать и управлять вашими ключами на странице «API Keys» в консоли. Пожалуйста, храните ваш API Key в безопасности, не раскрывайте его в публичных репозиториях кода или клиентском коде.

4Список поддерживаемых моделей

ID моделиНазвание моделиПоставщик
gpt-4oGPT-4oOpenAI
gpt-4o-miniGPT-4o MiniOpenAI
claude-3-5-sonnetClaude 3.5 SonnetAnthropic
claude-4-sonnetClaude 4 SonnetAnthropic
gemini-2-0-proGemini 2.0 ProGoogle
deepseek-v4-proDeepSeek-V4-ProDeepSeek
qwen-maxQwen-MaxAlibaba Cloud

Больше моделей подключаются постоянно, следите за нашими обновлениями.

5Примеры кода

curl

bash
curl https://www.token8341.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python (openai SDK)

python
from openai import OpenAI

client = OpenAI(
    base_url="https://www.token8341.com/v1",
    api_key="sk-your-api-key-here"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

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

Node.js (openai SDK)

javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.token8341.com/v1",
  apiKey: "sk-your-api-key-here",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "Hello!" },
  ],
});

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

6Описание кодов ошибок

При сбое запроса API возвращаются соответствующие HTTP-статус-коды и сообщения об ошибках в следующем формате:

json
{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}
Статус-кодНазваниеОписание
400Bad Request请求参数错误，请检查请求体格式
401UnauthorizedAPI Key 无效或缺失，请检查 Authorization 请求头
402Insufficient Balance账户余额不足，请充值后重试
404Not Found请求的模型或接口不存在
429Rate Limit请求频率过高，请稍后重试
500Internal Server Error服务内部错误，请联系技术支持
503Service Unavailable模型服务暂时不可用，请稍后重试

Частые вопросы по интеграции

Частые вопросы об API Key, переключении моделей и языках интеграции

Можно ли одним API Key вызывать все модели?

Да. Это ключевая особенность SiCore TokenWorks — разработчику достаточно подключиться один раз, чтобы вызывать все модели на платформе, без необходимости отдельно регистрировать аккаунты и управлять Key для каждого провайдера.

Нужно ли менять код при переключении модели?

Не нужно менять логику кода — достаточно изменить только один параметр, model ID, чтобы переключаться между отечественными и зарубежными моделями.

Какие языки программирования поддерживаются?

Предоставляются примеры интеграции на cURL, Python, Node.js и других популярных языках, совместимые с любым языком, поддерживающим HTTP-запросы, и с официальным SDK OpenAI.

Как происходит аутентификация API?

Аутентификация выполняется с помощью Bearer Token: достаточно передать API Key в заголовке запроса. Интерфейс полностью совместим с форматом Chat Completions от OpenAI, поэтому можно вызывать его напрямую через официальный SDK OpenAI без дополнительной адаптации.

Есть ли готовые SDK или примеры кода?

Да. Платформа предоставляет примеры подключения на cURL, Python, Node.js и других популярных языках — разработчики могут выбрать подходящий и быстро выполнить интеграцию.

Будут ли добавляться новые модели? Нужно ли менять код при подключении новых моделей?

Да. Платформа постоянно подключает новые китайские и международные популярные модели, способ подключения и система тарификации остаются едиными, поэтому после выхода новых моделей их можно сразу выбрать без изменения кода.

Как использовать механизм кэширования API больших моделей? В каких сценариях происходит попадание в кэш?

Платформа использует общий кэш для одинаковых prompt между пользователями: при попадании цена снижается ещё более чем на 90%, минимальная цена попадания в кэш — ¥0.010 / миллион Token, и часть с попаданием тарифицируется по цене кэша. Это подходит для сценариев, где несколько пользователей повторно используют одинаковый префикс prompt, например фиксированные системные подсказки, префиксы публичных знаний и т. п. — размещайте неизменяемую часть в начале, тогда вероятность попадания выше.

Как настроить автоматические повторные попытки и деградацию при сбое или тайм-ауте вызова API?

Обычный подход таков: для тайм-аутов и повторяемых ошибок использовать повторные попытки с экспоненциальной задержкой и задать максимальное число попыток; если всё равно не удаётся, переключиться на резервную модель. На платформе для смены модели достаточно изменить ID модели, код менять не нужно — просто укажите в качестве цели деградации ID другой модели. На стороне платформы также есть многоузловая избыточность и интеллектуальная маршрутизация между регионами: при сбое отдельного узла переключение происходит автоматически.

Как сравнить эффективность и стоимость разных моделей?

Один API Key позволяет вызывать все модели; для смены модели нужно изменить только ID модели, код менять не нужно, поэтому для横向 сравнения не требуется отдельно подключать каждую модель. Рекомендуется вызывать их по очереди на одной и той же выборке бизнес-примеров, фиксировать качество вывода и расход, а затем по «таблице сравнения цен всех моделей» на официальном сайте поэлементно сопоставлять официальную цену и цену на этом сайте.

Как безопасно хранить серверный API Key?

Рекомендуется хранить API Key только на сервере и передавать его через заголовок запроса способом Bearer Token, не записывая в код фронтенда или клиента. Запросы и ответы платформы передаются с шифрованием HTTPS на всём пути, а также предоставляются корпоративное управление правами и журналы аудита — записи вызовов можно отследить.

Как обеспечить стабильность вызовов и низкую задержку в сценариях с высокой конкурентностью?

Платформа опирается на вычислительные центры в Хэлингэре (Внутренняя Монголия), Хами (Синьцзян), Чжунвэй (Нинся) и других местах и с помощью собственного алгоритма планирования выполняет интеллектуальную маршрутизацию между регионами и динамическую балансировку нагрузки; при сбое отдельного узла переключение происходит автоматически. Пользователи в ключевых городах могут получить задержку в миллисекундах, гарантированная доступность сервиса — 99.9%. Рекомендуется дополнительно на стороне клиента использовать повторные попытки с задержкой и деградацию на несколько моделей.

Как отслеживать объём вызовов, расходы и аномалии?

Платформа предоставляет единый аккаунт и единую систему тарификации, расход прозрачен, баланс зачисляется в реальном времени, детализацию потребления можно посмотреть в любой момент; также предоставляется функция журналов аудита вызовов API — записи вызовов можно отследить. Корпоративные пользователи, которым нужны более строгие требования соответствия (управление правами, журналы аудита и т. п.), могут связаться со службой поддержки для взаимодействия с отделом продаж.