TokenWorks

توثيق API

دليل اندماج مفصل ومرجع API لمساعدتك على دمج خدمة TokenWorks AI API بسرعة

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قائمة النماذج المدعومة

معرف النموذجاسم النموذجالمزود
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模型服务暂时不可用,请稍后重试