TokenWorks

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

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

1Швидкий старт

Використання TokenWorks API складається лише з трьох простих кроків:

  1. Зареєструйте обліковий запис 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Спосіб автентифікації

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模型服务暂时不可用，请稍后重试