د چمتوکوونکو کټلاګ
د AI21 Jurassic API لارښود
د ګډ پېرودونکي chat-completion پایټکی د AI21 Jurassic د اوسنیو خپرو شوو ماډل پېژندونو او د خدمت د شتون سره وکاروئ.
- د API محصول وټاکئد اټکل غوښتنې د ماډل روزنې له کاري بهیر څخه جلا کړئ.
- د هغه تړون ولولئاړوند API مستندات او OpenAPI مرجع وکاروئ.
- ټاکلې کلۍ جوړه کړئد پېرودونکي API کلۍ جوړه او خوندي یې وساتئ.
- ادغام او تاییدمستنده غوښتنه ولېږئ او ځواب یې وګورئ.
- څارنه او بدلونکارونه وګورئ او د اړتیا پر مهال کلۍ لغوه یا بدله کړئ.
د AI21 Jurassic خپاره شوي ماډلونه
نومونه، د مسیر دقیق پېژندونه، نسخې او د اټکل حالت، که د ماډل ثبت فعال وي، له هغه څخه ښودل کېږي. تش پېژند معنا لري چې کټلاګ د مسیر ارزښت نه دی خپور کړی؛ له ماډل نومه یې مه اټکل کوئ.
| د ماډل نوم | د ماډل دقیق پېژند | نسخه | د اټکل حالت |
|---|---|---|---|
| Jurassic-2 | د مسیر پېژند نه دی خپور شوی | — | د عامه مسیر پېژندونکي له نشتوالي سره مستقیم زنګ وهل نه شي تاییدېدای. |
د دې چمتوکوونکي کارول
- ماډل د خپل دقیق پېژند له مخې وټاکئ او د اپلېکېشن تر تنظیم مخکې یې حالت تایید کړئ. د ښودلو نوم د خلکو لپاره دی؛ یوازې پېژند د model برخې ته مناسب دی.
- د هر چمتوکوونکي پاڼه د OpenAI-compatible او Claude Messages بېلګې لري. د خپل مراجع پروتوکول وټاکئ؛ ټاکل شوی ماډل هم باید د غوښتل شوو ځانګړنو ملاتړ وکړي.
- د یوازې اوسنیو پېرودونکو لپاره په خدمت کې، د اوسنیو حسابونو لاسرسی وساتئ او د ماډل خپور شوی لېست د نوي ګډون د پیل بلنه مه ګڼئ.
د ماډل API بېلګې
د غوښتنې د بېلګې د لیدلو لپاره د ماډل خپور شوی پېژند، د API پروتوکول او ژبه وټاکئ. د پېرودونکي API کیلي پر باوري سرور کې وساتئ.
اوس مهال فعال یا زوړ ماډل نشته چې د اټکل خپور شوی پېژند ولري.
Claude Messages · POST /messages
د Claude Messages غوښتنې POST /api/v1/messages کاروي. د پېرودونکي کیلي په x-api-key کې ولېږئ او anthropic-version یې 2023-06-01 وټاکئ. د Anthropic SDK base URL https://fusionpointai.com/api دی، ځکه SDK ورسره /v1/messages نښلوي؛ د Bearer تایید هم ملاتړ کېږي.
د Claude Messages proxy اصلي content blockونه او د توکو معلومات ساتي، او کله چې ټاکل شوی پورتهلاسی ماډل یې ملاتړ وکړي، د server-sent event رښتینی streaming هم برابروي.
| برخه | ډول | اړین | محدودیتونه |
|---|---|---|---|
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."}}
لومړنۍ غوښتنه ولېږئ
لاندې اصلي URL ته HTTPS غوښتنې واستوئ. د OpenAI-compatible متني خبرو لپاره POST /chat/completions او د Claude Messages لپاره POST /messages وکاروئ. د ماډل په کاريځای کې پروتوکول وټاکئ او د هماغه پروتوکول دقیق URL او JSON بڼه وکاروئ.
د API اصلي URL: https://fusionpointai.com/api/v1
د خپل حساب د API کیلي له تنظیماتو څخه د پېرودونکي کیلي جوړه یا مدیریت کړئ. د Bearer token په توګه یې واستوئ او پر باوري سرور یې وساتئ؛ د براوزر په کوډ، سرچینې کنټرول یا عامه log کې یې مه ږدئ.
کیلي د ai:inference ساحې او اړوند پېرودونکي ګډون ته لاسرسي ته اړتیا لري. عامه API کیلي د حساب پټنوم نه دی او له چا سره یې مه شریکوئ.
دا بېلګې د ثبت شوي JSON chat-completion پایټکي او د OpenAI-compatible Python او Node.js مراجعو څخه کار اخلي. کیلي د 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 او د متن string content لري. اختیاري تولیدي کنټرولونه باید د لاندې تایید حدونو کې وي. ځواب یو JSON chat.completion object دی چې choices او، که چمتوکوونکی یې راواستوي، د token کارونه لري.
| برخه | ډول | اړین | محدودیتونه |
|---|---|---|---|
model | string | هو | متن، تر ۱۶۰ تورو پورې؛ خپور شوی پېژند وکاروئ. |
messages | array | هو | له ۱ تر ۱۰۰ پیغامونو array. |
messages[].role | string | هو | هر role باید system، user یا assistant وي. |
messages[].content | string | هو | د هر پیغام content متن دی او تر ۱۰۰٬۰۰۰ تورو پورې وي. |
temperature | number | نه | اختیاري شمېره له ۰ تر ۲ پورې. |
max_tokens | integer | نه | اختیاري صحیح عدد له ۱ تر ۱۰۰٬۰۰۰ پورې؛ ټاکل شوی ماډل ښايي د پایلې ټیټ حد ولري. |
د ځواب بڼه
بریالی ځواب id، object (chat.completion)، created، model او choices لري. په یوه choice کې index، د assistant message او finish_reason وي. د token شمېر په 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
}
}
لاسرسی، محدودیتونه او خوندي عملیات
د پېرودونکو ژوندۍ ګډونونه د غوښتنو یا token کارونه د کوټې له مخې نه شمېرې؛ د sandbox کیلي د خپرې شوې میاشتنۍ ونډې له مخې محدوده ده. دا د ګډون شرط له ماډل او پورتهلاسي تخنیکي محدودیتونو جلا دی.
- د ماډل د متن کړکۍ، د پایلې اعظمي اندازه، ملاتړ شوې غوښتنې او د پورتهلاسي ترافیک لنډمهاله کنټرولونه توپیر لري. د تولیدي ترافیک لېږلو مخکې د چمتوکوونکي او ماډل معلومات وګورئ.
- د پایټکي د اپلېکېشن throttle د هر اړوند throttle هویت لپاره په دقیقه کې ۶۰ غوښتنې لري. HTTP 429 د پورتهلاسي لنډمهاله ترافیک کنټرول هم ښودلای شي؛ د پرلهپسې چټکو هڅو پر ځای د واټن په زیاتولو بیا هڅه وکړئ.
- HTTPS وکاروئ، کیلي پر سرور وساتئ، یوازې اړینه د اټکل ساحه ورکړئ او که د کیلي د افشا کېدو احتمال وي ژر یې لغوه کړئ.
- Chat Completions هممهاله متن ملاتړ کوي. Claude Messages جلا له اصلي content blockونو، توکو او SSE ملاتړ کوي، که ټاکل شوی ماډل یې مني. د چمتوکوونکو نور پایټکي د دغو تړونونو برخه نه دي.
د چمتوکوونکي لاسرسی او د حساب اړتیاوې
د پېرودونکي داسې API کیلي وکاروئ چې ai:inference ساحه ولري او د دې خدمت ته لاسرسي لرونکي حساب پورې تړلې وي. کټلاګ څرګندوي چې اوس نوی پېرودونکی منل کېږي که نه. دا لاسرسی نه ورکوي، ګډون نه جوړوي او د حساب یا کیلي اجازې نه بدلوي.
تېروتنې او ستونزههوارونه
د پایټکي له خوا بېرته ورکړل شوې تاییدي ناکامۍ او د چمتوکوونکي نهکارېدونکې پایلې د message، type او code لرونکی JSON error object کاروي؛ تاییدي ناکامۍ ښايي د برخو جزییات هم ولري. د ملاتړ په ټکټونو کې API کیلي یا د prompt خصوصي متن مه لېږئ.
د chat عملیاتو د غوښتنې تایید او د چمتوکوونکي ناکامۍ error object کاروي. د تایید، ساحې او throttle منځګړي ښايي پر ځای یې په root کې message field ورکړي. حالت او د ځواب متن دواړه وګورئ.
| HTTP حالت | مانا او بل ګام |
|---|---|
400 | د غوښتنې متن ناسم دی. اړینې برخې، د پیغامونو شمېر او منځپانګه، د role ارزښتونه، temperature او max_tokens وګورئ.
|
401 | Bearer کیلي ورکه یا ناسمه ده. تایید کړئ چې کیلي فعاله ده او د Authorization header کې لېږل شوې. |
403 | کېدای شي کیلي د اټکل اړینه ساحه یا د حساب لاسرسی ونه لري. د کیلي اجازې او د ګډون لاسرسی وڅېړئ. |
429 | د غوښتنې حد یا د پورتهلاسي ترافیک کنټرول پلي شوی. سرعت راکم او د واټن په زیاتولو بیا هڅه وکړئ. |
500 | چمتوکوونکي د کار وړ بشپړونه ورنه کړه یا خدمت ناکام شو. په احتیاط بیا هڅه وکړئ؛ د وخت او له حساسو معلوماتو پاک شوي غوښتنې پېژند سره له ملاتړ سره اړیکه ونیسئ. |
ډېرې پوښتل شوې پوښتنې
ایا د ښودلو نوم د ماډل ارزښت په توګه کارولای شم؟
یوازې هغه وخت چې هماغه دقیق متن د مسیر پېژند په توګه جلا خپور شوی وي. د پېژند ستون وکاروئ؛ که تش وي، دلته د مسیر ارزښت نه دی خپور شوی.
ایا د Claude SDK کارولای شم؟
هو. د ماډل په کاريځای کې Claude وټاکئ او د ښودل شوي base URL سره Anthropic SDK وکاروئ. دا اصلي Messages غوښتنې لېږي، نه Chat Completions. د ماډل ځانګړې وړتیاوې بیا هم پلي کېږي.
ولې لېست شوی ماډل ناکامېدای شي؟
ماډل ښايي شتون ونه لري، ستاسو د حساب یا کیلي لپاره لاسرسی فعال نه وي، یا د پورتهلاسي تخنیکي حد لګېدلی وي. حالت، پېژند، د کیلي ساحه او د تېروتنې ځواب وګورئ.
د ملاتړ غوښتنه کې څه ولیکم؟
د چمتوکوونکي نوم، د ماډل دقیق پېژند، د غوښتنې وخت، HTTP حالت او له حساسو معلوماتو پاک شوی د غوښتنې پېژند ولیکئ. API کیلي او حساس prompt معلومات لرې کړئ.