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: यह इंटरफ़ेस OpenAI के Chat Completions इंटरफ़ेस प्रारूप के साथ पूरी तरह संगत है, आप सीधे OpenAI SDK का उपयोग करके कॉल कर सकते हैं।

3प्रमाणीकरण विधि

TokenWorks API प्रमाणीकरण के लिए Bearer Token का उपयोग करता है। कृपया अपने अनुरोध हेडर में अपनी 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模型服务暂时不可用，请稍后重试