بازدان بۆ ناوەڕۆکی سەرەکی

کاتەلۆگی دابینکەر

ڕێنماییی APIی DeepSeek GPT

خاڵی کۆتاییی هاوبەشی chat-completionی کڕیار لەگەڵ ناسنامەی مۆدێلی DeepSeek GPTی ئێستا بڵاوکراوە و بەردەستبوونی خزمەتگوزاری بەکاربهێنە.

ڕەوتی کار
  1. بەرهەمی API هەڵبژێرەداواکاریی inference لە ڕەوتی کاری model-training جیا بکەرەوە.
  2. گرێبەستی بەکارهێنانی بخوێنەوەبەڵگەنامەی API و سەرچاوەی OpenAPIی گونجاو بەکاربهێنە.
  3. کلیلێکی سنووردار دروست بکەکلیلی APIی کڕیار بە ئاسایش دروست و هەڵبگرە.
  4. یەکخستن جێبەجێ و پشتڕاست بکەرەوەداواکارییەکی بەڵگەکراو بنێرە و وەڵامەکەی بپشکنە.
  5. چاودێری و گۆڕینی کلیل بکەبەکارهێنان بپشکنە و کلیل کاتێک گونجاو بوو هەڵبوەشێنەوە یان بیگۆڕە.

مۆدێلە بڵاوکراوەکانی DeepSeek GPT

ناو، ناسنامەی ڕێنەریی ورد، وەشان و دۆخی inference لە تۆماری مۆدێلی چالاککراوەوە پیشان دەدرێن ئەگەر بەردەست بێت. ناسنامەی بەتاڵ واتە کاتەلۆگەکە بەهای ڕێنەریی بڵاونەکردووەتەوە؛ لە ناوی مۆدێلەوە خۆت دروستی مەکە.

گەشەپێدەر
DeepSeek
دەستگەیشتنی کڕیاری نوێ
تەنها بۆ کڕیارانی ئێستا
ناوی مۆدێلناسنامەی تەواوی مۆدێلوەشاندۆخی 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 نەخێر []
Claude Messages · نموونە
{
    "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 بە ناسنامەیەکی وردی لیستی سەرەوە بگۆڕە.

Shell
# 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 — نموونە
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
}'
Python — نموونە
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)
Node.js — نموونە
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 و، ئەگەر دابینکەر بگەڕێنێتەوە، بەکارهێنانی تۆکنی تێدایە.

خانەجۆرپێویستەسنوورەکان
modelstringبەڵێString، زۆرترین 160 پیت؛ ناسنامەی بڵاوکراوە بەکاربهێنە.
messagesarrayبەڵێئارایەیەک لە 1 تا 100 پەیام.
messages[].rolestringبەڵێroleی هەر پەیامێک system، user یان assistantە.
messages[].contentstringبەڵێناوەڕۆکی هەر پەیامێک stringێکە تا 100,000 پیت.
temperaturenumberنەخێرژمارەیەکی هەڵبژاردەیی لە 0 تا 2.
max_tokensintegerنەخێرژمارەی تەواوی هەڵبژاردەیی لە 1 تا 100,000؛ ڕەنگە مۆدێلی هەڵبژێردراو سنووری دەرچوونی کەمتر هەبێت.

شێوەی وەڵام

وەڵامی سەرکەوتوو id، object (chat.completion)، created، model و choices دەگرێتەوە. هەر choiceێک index، messageی assistant و finish_reasonی تێدایە. ڕەنگە ژمارەی تۆکن لە usageدا بگەڕێندرێتەوە. سنووری تایبەت بە دابینکەر هەیە تەنانەت ئەگەر داواکارییەکە لە پشتڕاستکردنەوەی gateway تێپەڕێت.

نموونە · JSON
{
    "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 یان دەستگەیشتنی هەژماری نەبێت. مۆڵەتەکانی کلیل و دەستگەیشتنی بەشداریکردن بپشکنە.
429throttleی داواکاری یان کۆنترۆڵی هاتوچۆی دابینکەری سەرەوە جێبەجێ کراوە. خاوتر بکە و بە دواخستنی زیادبوو دووبارە هەوڵ بدەرەوە.
500دابینکەر وەڵامێکی بەکارهێنراوی نەگەڕاندووەتەوە یان خزمەتگوزارییەکە شکستیهێناوە. بە وریایی دووبارە هەوڵ بدەرەوە؛ بە کاتی ڕووداو و ناسنامەی داواکاریی لابراو پەیوەندی بە پشتگیرییەوە بکە.

پرسیارە باوەکان

ئایا دەتوانم ناوی پیشاندان وەک بەهای مۆدێل بەکاربهێنم؟

تەنها ئەگەر هەمان دەق بە جیا وەک ناسنامەی ڕێنەری بڵاوکرابێتەوە. ستوونی ناسنامە بەکاربهێنە؛ ئەگەر بەتاڵە، لێرە هیچ بەهای ڕێنەرییەک بڵاونەکراوەتەوە.

ئایا دەتوانم Claude SDK بەکاربهێنم؟

بەڵێ. Claude لە کارگەی مۆدێل هەڵبژێرە و Anthropic SDK لەگەڵ URLی بنەڕەتیی پیشاندراو بەکاربهێنە. داواکاریی Messagesی سروشتی دەنێرێت، نەک Chat Completions. تواناکانی تایبەت بە مۆدێل هەروا کاریگەرن.

بۆچی ڕەنگە مۆدێلێکی لیستکراو کار نەکات؟

لەوانەیە مۆدێلەکە بەردەست نەبێت، دەستگەیشتن بۆ هەژمار یان کلیلەکەت چالاک نەکرابێت، یان سنوورێکی تەکنیکیی دابینکەری سەرەوە کاریگەر بێت. دۆخ، ناسنامە، مەودای کلیل و وەڵامی هەڵە بپشکنە.

لە داواکاریی پشتگیریدا چی بنووسم؟

دابینکەر، ناسنامەی تەواوی مۆدێل، کاتی داواکاری، دۆخی HTTP و ناسنامەی داواکاریی لابراو بنووسە. کلیلەکانی API و داتای هەستیارەکانی پرۆمپت لاببە.