SiCore TokenWorks

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

Детальні посібники з підключення та довідник API, щоб швидко інтегрувати API-сервіс SiCore TokenWorks AI

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, і записи викликів можна відстежити. Корпоративні користувачі, яким потрібні суворіші вимоги відповідності (управління правами, журнали аудиту тощо), можуть звернутися до служби підтримки для комерційного підключення.