TokenWorks

مستندات API

راهنمای اتصال دقیق و مرجع API، برای ادغام سریع شما با سرویس API هوش مصنوعی TokenWorks

1شروع سریع

استفاده از API TokenWorks فقط سه مرحله ساده دارد:

  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لیست مدل‌های پشتیبانی‌شده

شناسه مدلنام مدلتأمین‌کننده
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模型服务暂时不可用,请稍后重试