کاتەلۆگی دابینکەر
ڕێنماییی APIی DeepSeek GPT
خاڵی کۆتاییی هاوبەشی chat-completionی کڕیار لەگەڵ ناسنامەی مۆدێلی DeepSeek GPTی ئێستا بڵاوکراوە و بەردەستبوونی خزمەتگوزاری بەکاربهێنە.
- بەرهەمی API هەڵبژێرەداواکاریی inference لە ڕەوتی کاری model-training جیا بکەرەوە.
- گرێبەستی بەکارهێنانی بخوێنەوەبەڵگەنامەی API و سەرچاوەی OpenAPIی گونجاو بەکاربهێنە.
- کلیلێکی سنووردار دروست بکەکلیلی APIی کڕیار بە ئاسایش دروست و هەڵبگرە.
- یەکخستن جێبەجێ و پشتڕاست بکەرەوەداواکارییەکی بەڵگەکراو بنێرە و وەڵامەکەی بپشکنە.
- چاودێری و گۆڕینی کلیل بکەبەکارهێنان بپشکنە و کلیل کاتێک گونجاو بوو هەڵبوەشێنەوە یان بیگۆڕە.
مۆدێلە بڵاوکراوەکانی DeepSeek GPT
ناو، ناسنامەی ڕێنەریی ورد، وەشان و دۆخی inference لە تۆماری مۆدێلی چالاککراوەوە پیشان دەدرێن ئەگەر بەردەست بێت. ناسنامەی بەتاڵ واتە کاتەلۆگەکە بەهای ڕێنەریی بڵاونەکردووەتەوە؛ لە ناوی مۆدێلەوە خۆت دروستی مەکە.
| ناوی مۆدێل | ناسنامەی تەواوی مۆدێل | وەشان | دۆخی inference |
|---|---|---|---|
| DeepSeek-V3 | هیچ ناسنامەی ڕێنەرییەک بڵاونەکراوەتەوە | — | بەردەستبوونی پەیوەندیی ڕاستەوخۆ ناتوانرێت پشتڕاست بکرێتەوە بەبێ ناسێنەری ڕێنیشاندانی گشتی. |
| DeepSeek-R1 | هیچ ناسنامەی ڕێنەرییەک بڵاونەکراوەتەوە | — | بەردەستبوونی پەیوەندیی ڕاستەوخۆ ناتوانرێت پشتڕاست بکرێتەوە بەبێ ناسێنەری ڕێنیشاندانی گشتی. |
تەنها بۆ کڕیارانی ئێستا
بەکارهێنانی ئەم دابینکەرە
- مۆدێلێک بە ناسنامەی تەواوی خۆی هەڵبژێرە و پێش ڕێکخستنی بەرنامە دۆخی بپشکنە. ناوی پیشاندان بۆ خوێنەرە؛ تەنها ناسنامەکە بۆ خانەی مۆدێل گونجاوە.
- هەر لاپەڕەی دابینکەر نموونەی OpenAI-compatible و Claude Messages پێشکەش دەکات. ئەو پرۆتۆکۆلە هەڵبژێرە کە کڕیارەکەت بەکاری دەهێنێت؛ مۆدێلی هەڵبژێردراو دەبێت تایبەتمەندیی داواکراویش پشتگیری بکات.
- بۆ خزمەتگوزاریی تەنها بۆ کڕیارانی ئێستا، دەستگەیشتنی هەژماری ئێستا بپارێزە و لیستی مۆدێلە بڵاوکراوەکان بە بانگهێشت بۆ دەستپێکردنی بەشداریکردنی نوێ مەزانە.
نموونەکانی APIی مۆدێل
ناسێنەری مۆدێلی بڵاوکراوە، پرۆتۆکۆلی API و زمان هەڵبژێرە بۆ بینینی نموونەی داواکاری. کلیلی APIی کڕیار لە ڕاژەخزمەتێکی متمانەپێکراودا بهێڵەوە.
ئێستا هیچ مۆدێلی چالاک یان کۆنی خاوەن ناسێنەری inferenceی بڵاوکراوە بەردەست نییە.
Claude Messages · POST /messages
داواکارییەکانی Claude Messages، POST /api/v1/messages بەکاردەهێنن. کلیلی کڕیار لە x-api-key بنێرە و anthropic-version بکە بە 2023-06-01. URLی بنەمای Anthropic SDK https://fusionpointai.com/apiیە چونکە SDK، /v1/messages زیاد دەکات؛ پشتڕاستکردنەوەی Bearerیش پشتگیری دەکرێت.
پرۆکسیی Claude Messages، بلۆکی ناوەڕۆکی سروشتی، داتای ئامراز و streamingی ڕاستەقینەی server-sent event دەپارێزێت ئەگەر مۆدێلی upstreamی هەڵبژێردراو پشتگیرییان بکات.
| خانە | جۆر | پێویستە | سنوورەکان |
|---|---|---|---|
model |
string |
بەڵێ | {"minLength":1,"maxLength":160} |
max_tokens |
integer |
بەڵێ | {"minimum":1,"maximum":100000} |
messages |
array |
بەڵێ | {"minItems":1,"maxItems":100,"items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","maxLength":80}},"additionalProperties":true}}]}}}} |
system |
string | array |
نەخێر | {"oneOf":[{"type":"string"},{"type":"array","items":{"type":"object","required":["type","text"],"properties":{"type":{"const":"text"},"text":{"type":"string"}},"additionalProperties":true}}]} |
stream |
boolean |
نەخێر | {"default":false} |
temperature |
number |
نەخێر | {"minimum":0,"maximum":1} |
top_p |
number |
نەخێر | {"minimum":0,"maximum":1} |
top_k |
integer |
نەخێر | {"minimum":0,"maximum":100000} |
stop_sequences |
array |
نەخێر | {"items":{"type":"string"}} |
tools |
array |
نەخێر | {"items":{"type":"object","additionalProperties":true}} |
tool_choice |
object |
نەخێر | {"additionalProperties":true} |
thinking |
object |
نەخێر | {"additionalProperties":true} |
metadata |
object |
نەخێر | {"additionalProperties":true} |
output_config |
object |
نەخێر | {"additionalProperties":true} |
service_tier |
string |
نەخێر | [] |
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "<MODEL_ID_FROM_CATALOGUE>",
"content": [
{
"type": "text",
"text": "A concise answer to the supplied question."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 12,
"output_tokens": 10
}
}
{"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key."}}
یەکەم داواکارییەکەت بنێرە
داواکاریی HTTPS بۆ URLی بنەڕەتیی خوارەوە بنێرە. بۆ گفتوگۆی دەقی گونجاو لەگەڵ OpenAI، POST /chat/completions بەکاربهێنە؛ بۆ Claude Messages، POST /messages. پرۆتۆکۆلەکە لە کارگەی مۆدێل هەڵبژێرە و URL و فۆرماتی JSONی تایبەتیی ئەو بەکاربهێنە.
URLی بنەڕەتیی API: https://fusionpointai.com/api/v1
لە ڕێکخستنەکانی کلیلەکانی APIی هەژمارت، کلیلی APIی کڕیار دروست بکە یان بەڕێوەی ببە. وەک bearer token بینێرە و لە سێرڤەرێکی متمانەپێکراودا بیپارێزە؛ لە کۆدی وێبگەڕ، کۆنترۆڵی وەشان یان لۆگی گشتیدا دایمەزرێنە.
کلیلەکە پێویستی بە مەودای ai:inference و دەستگەیشتن بە بەشداریکردنی پەیوەندیداری کڕیار هەیە. کلیلی گشتیی API وشەی نهێنیی هەژمار نییە و نابێت هاوبەشی پێ بکرێت.
ئەم نموونانە خاڵی کۆتاییی تۆمارکراوی JSON chat-completion و کڕیارەکانی Python و Node.jsی گونجاو لەگەڵ OpenAI بەکاردەهێنن. کلیلەکە لە گۆڕاوی ژینگەی FUSIONPOINTAI_API_KEYدا هەڵبگرە. تەنها بەهای model بە ناسنامەیەکی وردی لیستی سەرەوە بگۆڕە.
# Install the client for your application language.
# Python:
python -m pip install openai
# Node.js:
npm install openai
# Bash: enter the key without storing it in shell history.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
# After finishing:
# unset FUSIONPOINTAI_API_KEY
ئێستا هیچ ناسنامەی مۆدێلێکی تۆماری چالاک بڵاونەکراوەتەوە. تەنها دوای هەڵبژاردنی ناسنامەیەک لەم کاتەلۆگە، جێگرەوەی نموونەکە بگۆڕە.
curl 'https://fusionpointai.com/api/v1/chat/completions' \
-H "Authorization: Bearer $FUSIONPOINTAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "<MODEL_ID_FROM_CATALOGUE>",
"messages": [
{
"role": "user",
"content": "Summarize this in one sentence."
}
],
"temperature": 0.7,
"max_tokens": 300
}'
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FUSIONPOINTAI_API_KEY"],
base_url="https://fusionpointai.com/api/v1",
)
response = client.chat.completions.create(
model="<MODEL_ID_FROM_CATALOGUE>",
messages=[{"role": "user", "content": "Summarize this in one sentence."}],
temperature=0.7,
max_tokens=300,
)
print(response.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FUSIONPOINTAI_API_KEY,
baseURL: "https://fusionpointai.com/api/v1",
});
const response = await client.chat.completions.create({
model: "<MODEL_ID_FROM_CATALOGUE>",
messages: [{ role: "user", content: "Summarize this in one sentence." }],
temperature: 0.7,
max_tokens: 300,
});
console.log(response.choices[0].message.content);
OpenAI · گرێبەستی داواکاری و وەڵام
خاڵی کۆتایی JSON وەردەگرێت. پەیامەکان بە ڕیز دەنێردرێن؛ هەر پەیامێک roleێکی پشتگیریکراو و contentێکی stringی تێدایە. کۆنتڕۆڵە هەڵبژاردەکانی بەرهەمهێنان دەبێت لە سنووری پشتڕاستکردنەوەی خوارەوەدا بمێننەوە. وەڵامەکە شێوەی ئۆبجێکتی JSONی chat.completionە و choices و، ئەگەر دابینکەر بگەڕێنێتەوە، بەکارهێنانی تۆکنی تێدایە.
| خانە | جۆر | پێویستە | سنوورەکان |
|---|---|---|---|
model | string | بەڵێ | String، زۆرترین 160 پیت؛ ناسنامەی بڵاوکراوە بەکاربهێنە. |
messages | array | بەڵێ | ئارایەیەک لە 1 تا 100 پەیام. |
messages[].role | string | بەڵێ | roleی هەر پەیامێک system، user یان assistantە. |
messages[].content | string | بەڵێ | ناوەڕۆکی هەر پەیامێک stringێکە تا 100,000 پیت. |
temperature | number | نەخێر | ژمارەیەکی هەڵبژاردەیی لە 0 تا 2. |
max_tokens | integer | نەخێر | ژمارەی تەواوی هەڵبژاردەیی لە 1 تا 100,000؛ ڕەنگە مۆدێلی هەڵبژێردراو سنووری دەرچوونی کەمتر هەبێت. |
شێوەی وەڵام
وەڵامی سەرکەوتوو id، object (chat.completion)، created، model و choices دەگرێتەوە. هەر choiceێک index، messageی assistant و finish_reasonی تێدایە. ڕەنگە ژمارەی تۆکن لە usageدا بگەڕێندرێتەوە. سنووری تایبەت بە دابینکەر هەیە تەنانەت ئەگەر داواکارییەکە لە پشتڕاستکردنەوەی gateway تێپەڕێت.
{
"id": "chatcmpl_example",
"object": "chat.completion",
"created": 1700000000,
"model": "<MODEL_ID_FROM_CATALOGUE>",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "A concise summary of the supplied text."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 10,
"total_tokens": 22
}
}
دەستگەیشتن، سنوور و کارکردنی پارێزراو
بەشداریکردنی کڕیاری چالاک داواکاری یان بەکارهێنانی تۆکن بەرامبەر کوۆتا ناپێوێت؛ کلیلی sandbox سنووردارە بە ڕێگەپێدانی مانگانەی بڵاوکراوەی خۆی. ئەم باسەی بەشداریکردن جیاوازە لە سنووری تەکنیکیی مۆدێل و دابینکەری سەرەوە.
- پەنجەرەی کۆنتێکستی مۆدێل، زۆرترین قەبارەی دەرچوون، تایبەتمەندییە پشتگیریکراوەکانی داواکاری و کۆنترۆڵی کاتیی هاتوچۆی دابینکەری سەرەوە جیاوازن. پێش ناردنی هاتوچۆی بەرهەمهێنان، زانیاریی دابینکەر و مۆدێل بپشکنە.
- خاڵی کۆتایی throttleی بەرنامەییی 60 داواکاری لە خولەکێکدا بۆ هەر ناسنامەی پەیوەندیداری throttle هەیە. HTTP 429 هەروەها دەکرێت نیشانەی کۆنترۆڵی کاتیی هاتوچۆی دابینکەری سەرەوە بێت؛ بە دواخستنی زیادبوو دووبارە هەوڵ بدەرەوە، نەک بە لووپی خێرا.
- HTTPS بەکاربهێنە، کلیلەکان لە لای سێرڤەر بهێڵەوە، تەنها مەودای پێویستی inference بدە و ئەگەر گومان لە ئاشکرا بوونی کلیلێک هەبوو، بێدرەنگ هەڵیبوەشێنەوە.
- Chat Completions پشتگیریی دەقی هاوکات دەکات. Claude Messages بە جیاوازی، بلۆکی ناوەڕۆکی سروشتی، ئامرازەکان و SSEی پشتگیریکراو لەلایەن مۆدێلی هەڵبژێردراوەوە دەگرێتەوە. خاڵەکانی کۆتاییی دابینکەرانی تر لەم گرێبەستانەدا نین.
دەستگەیشتن بە دابینکەر و پێداویستیی هەژمار
بە کلیلی APIی کڕیار پشتڕاست بکەرەوە کە مەودای ai:inferenceی هەیە و سەر بە هەژمارێکە کە دەستگەیشتنی بەو خزمەتگوزارییە هەیە. کاتەلۆگ دەردەخات ئایا ئێستا کڕیاری نوێ ڕێگەپێدراوە. دەستگەیشتن نادات، بەشداریکردن دروست ناکات و دەسەڵاتی هەژمار و کلیل ناگۆڕێت.
هەڵە و چارەسەرکردنی کێشە
شکستی پشتڕاستکردنەوە و ئەنجامی بەکارهێنەنەکراوی دابینکەر کە خاڵی کۆتایی دەیگەڕێنێتەوە، ئۆبجێکتێکی هەڵەی JSON بە message، type و code بەکاردەهێنن؛ لەوانەیە شکستی پشتڕاستکردنەوە وردەکاریی خانەش بخاتە ناوەوە. کلیلی API یان ناوەڕۆکی تایبەتیی پرۆمپت لە داواکاریی پشتگیریدا مەخەرەوە.
پشتڕاستکردنەوەی داواکاری و شکستی دابینکەر لەلایەن کرداری chatەوە بە ئۆبجێکتی هەڵە دەگەڕێندرێنەوە. Middlewareی پشتڕاستکردنەوە، مەودا و throttle لەوانەیە لەبری ئەوە خانەی messageی سەرەکی بگەڕێنێتەوە. دۆخی HTTP و جەستەی وەڵام پێکەوە بپشکنە.
| دۆخی HTTP | واتا و هەنگاوی دواتر |
|---|---|
400 | جەستەی داواکاری نادروستە. خانە پێویستەکان، ژمارە و ناوەڕۆکی پەیامەکان، بەهاکانی role، temperature و max_tokens بپشکنە.
|
401 | کلیلی bearer نییە یان نادروستە. دڵنیا ببە کلیلەکە چالاکە و لە هێدەری Authorization نێردراوە. |
403 | ڕەنگە کلیلەکە مەودای پێویستی inference یان دەستگەیشتنی هەژماری نەبێت. مۆڵەتەکانی کلیل و دەستگەیشتنی بەشداریکردن بپشکنە. |
429 | throttleی داواکاری یان کۆنترۆڵی هاتوچۆی دابینکەری سەرەوە جێبەجێ کراوە. خاوتر بکە و بە دواخستنی زیادبوو دووبارە هەوڵ بدەرەوە. |
500 | دابینکەر وەڵامێکی بەکارهێنراوی نەگەڕاندووەتەوە یان خزمەتگوزارییەکە شکستیهێناوە. بە وریایی دووبارە هەوڵ بدەرەوە؛ بە کاتی ڕووداو و ناسنامەی داواکاریی لابراو پەیوەندی بە پشتگیرییەوە بکە. |
پرسیارە باوەکان
ئایا دەتوانم ناوی پیشاندان وەک بەهای مۆدێل بەکاربهێنم؟
تەنها ئەگەر هەمان دەق بە جیا وەک ناسنامەی ڕێنەری بڵاوکرابێتەوە. ستوونی ناسنامە بەکاربهێنە؛ ئەگەر بەتاڵە، لێرە هیچ بەهای ڕێنەرییەک بڵاونەکراوەتەوە.
ئایا دەتوانم Claude SDK بەکاربهێنم؟
بەڵێ. Claude لە کارگەی مۆدێل هەڵبژێرە و Anthropic SDK لەگەڵ URLی بنەڕەتیی پیشاندراو بەکاربهێنە. داواکاریی Messagesی سروشتی دەنێرێت، نەک Chat Completions. تواناکانی تایبەت بە مۆدێل هەروا کاریگەرن.
بۆچی ڕەنگە مۆدێلێکی لیستکراو کار نەکات؟
لەوانەیە مۆدێلەکە بەردەست نەبێت، دەستگەیشتن بۆ هەژمار یان کلیلەکەت چالاک نەکرابێت، یان سنوورێکی تەکنیکیی دابینکەری سەرەوە کاریگەر بێت. دۆخ، ناسنامە، مەودای کلیل و وەڵامی هەڵە بپشکنە.
لە داواکاریی پشتگیریدا چی بنووسم؟
دابینکەر، ناسنامەی تەواوی مۆدێل، کاتی داواکاری، دۆخی HTTP و ناسنامەی داواکاریی لابراو بنووسە. کلیلەکانی API و داتای هەستیارەکانی پرۆمپت لاببە.