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

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

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

گەشەپێدەر

OpenAI

دەستگەیشتنی کڕیاری نوێ

بەردەستە

یەکەم داواکارییەکەت بنێرە

داواکاریی 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": "gpt-6.1-sol",
    "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="gpt-6.1-sol",
    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: "gpt-6.1-sol",
  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 و، ئەگەر دابینکەر بگەڕێنێتەوە، بەکارهێنانی تۆکنی تێدایە.

شێوەی وەڵام

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

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "gpt-6.1-sol",
    "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 و جەستەی وەڵام پێکەوە بپشکنە.

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