API दस्तावेज़
विस्तृत एकीकरण मार्गदर्शिका और API संदर्भ, जो आपको 8341TokenFactory AI API सेवा को शीघ्रता से एकीकृत करने में सहायता करेगा
1त्वरित आरंभ
8341TokenFactory API का उपयोग करने के लिए केवल तीन सरल चरण:
- 8341TokenFactory खाता पंजीकृत करें और कंसोल में लॉग इन करें
- कंसोल में API Key बनाएं
- अपनी API Key का उपयोग करके हमारे इंटरफ़ेस को कॉल करें
Tip: नए उपयोगकर्ताओं को पंजीकरण के बाद निःशुल्क परीक्षण कोटा मिलेगा, बिना क्रेडिट कार्ड जोड़े उपयोग शुरू कर सकते हैं।
2इंटरफ़ेस पता
API का आधार पता नीचे दिया गया है, सभी अनुरोध HTTPS प्रोटोकॉल का उपयोग करते हैं:
text
https://www.token8341.com/v1चैट पूर्णता इंटरफ़ेस:
text
POST https://www.token8341.com/v1/chat/completionsNote: यह इंटरफ़ेस OpenAI के Chat Completions इंटरफ़ेस प्रारूप के साथ पूरी तरह संगत है, आप सीधे OpenAI SDK का उपयोग करके कॉल कर सकते हैं।
3प्रमाणीकरण विधि
8341TokenFactory API प्रमाणीकरण के लिए Bearer Token का उपयोग करता है। कृपया अपने अनुरोध हेडर में अपनी API Key शामिल करें:
text
Authorization: Bearer sk-your-api-key-hereआप कंसोल के 'API Keys' पृष्ठ पर अपनी कुंजियाँ बना और प्रबंधित कर सकते हैं। कृपया अपनी API Key को सुरक्षित रखें, इसे सार्वजनिक कोड रिपॉजिटरी या क्लाइंट कोड में उजागर न करें।
4समर्थित मॉडल सूची
| मॉडल ID | मॉडल नाम | प्रदाता | 状态 |
|---|---|---|---|
| deepseek-v4.1-flash | DeepSeek V4.1 Flash | DeepSeek | 可用 |
| deepseek-v4-pro | DeepSeek V4 Pro | DeepSeek | 可用 |
| deepseek-v4-flash | DeepSeek V4 Flash | DeepSeek | 可用 |
| kimi-k3 | Kimi K3 | Moonshot | 可用 |
| kimi-k2.5 | Kimi K2.5 | Moonshot | 可用 |
| glm-5.3 | GLM-5.3 | Zhipu | 可用 |
| glm-4.7-flash | GLM-4.7 Flash | Zhipu | 可用 |
| qwen3.8-max | Qwen3.8 Max | Alibaba Cloud | 可用 |
| qwen3.8-plus | Qwen3.8 Plus | Alibaba Cloud | 可用 |
| minimax-m3 | MiniMax M3 | MiniMax | 可用 |
| doubao-seed-2.1-pro | Doubao Seed 2.1 Pro | ByteDance | 可用 |
| ernie-5.1 | ERNIE 5.1 | Baidu | 可用 |
| - | GPT-4o / Claude / Gemini | OpenAI / Anthropic / Google | 暂未开放 |
अधिक मॉडल लगातार जोड़े जा रहे हैं, कृपया हमारे अपडेट घोषणाओं पर ध्यान दें।
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": "deepseek-v4.1-flash",
"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="deepseek-v4.1-flash",
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: "deepseek-v4.1-flash",
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
}
}| स्थिति कोड | नाम | विवरण |
|---|---|---|
| 400 | Bad Request | 请求参数错误，请检查请求体格式 |
| 401 | Unauthorized | API Key 无效或缺失，请检查 Authorization 请求头 |
| 402 | Insufficient Balance | 账户余额不足，请充值后重试 |
| 404 | Not Found | 请求的模型或接口不存在 |
| 429 | Rate Limit | 请求频率过高，请稍后重试 |
| 500 | Internal Server Error | 服务内部错误，请联系技术支持 |
| 503 | Service Unavailable | 模型服务暂时不可用，请稍后重试 |
इंटीग्रेशन संबंधी सामान्य प्रश्न
API Key, मॉडल स्विचिंग और इंटीग्रेशन भाषाओं से जुड़े सामान्य प्रश्न
क्या एक API Key से सभी मॉडल कॉल किए जा सकते हैं?
हाँ। यह 8341TokenFactory की मुख्य विशेषता है—डेवलपर्स को केवल एक बार इंटीग्रेट करना होता है, जिसके बाद वे प्लेटफ़ॉर्म के सभी मॉडल कॉल कर सकते हैं, बिना प्रत्येक विक्रेता के लिए अलग खाता बनाने और Key प्रबंधित करने की आवश्यकता के।
क्या मॉडल स्विच करने के लिए कोड बदलना पड़ता है?
लॉजिक कोड बदलने की आवश्यकता नहीं है, केवल मॉडल ID एक पैरामीटर बदलकर घरेलू और विदेशी मॉडलों के बीच स्विच किया जा सकता है।
कौन-कौन सी प्रोग्रामिंग भाषाएँ समर्थित हैं?
cURL, Python, Node.js आदि प्रमुख इंटीग्रेशन उदाहरण प्रदान किए गए हैं, जो HTTP अनुरोध का समर्थन करने वाली किसी भी भाषा और OpenAI आधिकारिक SDK के साथ संगत हैं।
API कैसे प्रमाणित होता है?
प्रमाणीकरण Bearer Token के माध्यम से होता है, अनुरोध हेडर में API Key शामिल करें; इंटरफ़ेस OpenAI के Chat Completions प्रारूप के साथ पूरी तरह संगत है, सीधे OpenAI के आधिकारिक SDK का उपयोग करके कॉल किया जा सकता है, किसी अतिरिक्त अनुकूलन की आवश्यकता नहीं है।
क्या तैयार 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 कॉल के ऑडिट लॉग सुविधा प्रदान करता है, कॉल रिकॉर्ड ट्रेस करने योग्य हैं। एंटरप्राइज़ उपयोगकर्ताओं को यदि अधिक कड़ी अनुपालन आवश्यकताएँ (अनुमति प्रबंधन, ऑडिट लॉग आदि) हों, तो ग्राहक सेवा से संपर्क करके व्यवसाय समन्वय कर सकते हैं।