دليل API لمقدم الخدمة Moonshot Kimi

نماذج Moonshot Kimi المنشورة

تُدرج الأسماء ومعرّفات التوجيه الدقيقة والإصدارات وحالة الاستدلال من سجل النماذج المفعّل متى كان متاحاً. يعني المعرف الفارغ أن الكتالوج لم ينشر قيمة توجيه؛ فلا تستنتجها من اسم النموذج.

المطوّر

Moonshot AI

إتاحة الخدمة للعملاء الجدد

متاح

إرسال طلبك الأول

أرسل طلبات HTTPS إلى العنوان الأساسي أدناه. استخدم POST /chat/completions للمحادثة النصية المتوافقة مع OpenAI أو POST /messages لبروتوكول Claude Messages. اختر البروتوكول في مساحة عمل النموذج واستخدم عنوانه الدقيق وتنسيق JSON الخاص به.

عنوان URL الأساسي لـ API: https://fusionpointai.com/api/v1

أنشئ مفتاح API للعميل أو أدره من إعدادات مفاتيح API في حسابك. أرسله كرمز bearer واحتفظ به على خادم موثوق؛ ولا تضعه في شيفرة المتصفح أو التحكم بالمصدر أو سجل عام.

يحتاج المفتاح إلى نطاق ai:inference وإمكانية الوصول إلى اشتراك العميل المعني. مفتاح API العام ليس كلمة مرور الحساب ويجب عدم مشاركته.

تستخدم هذه الأمثلة نقطة نهاية إكمال المحادثة JSON المسجلة وعملاء 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": "kimi-k3.1-pro",
    "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="kimi-k3.1-pro",
    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: "kimi-k3.1-pro",
  messages: [{ role: "user", content: "Summarize this in one sentence." }],
  temperature: 0.7,
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

OpenAI · عقد الطلب والاستجابة

تقبل نقطة النهاية JSON. تُرسل الرسائل بالترتيب، ولكل رسالة دور مدعوم ومحتوى نصي. يجب أن تظل عناصر التحكم الاختيارية في التوليد ضمن حدود التحقق أدناه. تكون الاستجابة كائن chat.completion بصيغة JSON، ويحتوي على choices واستخدام الرموز عند إعادته من مقدم الخدمة.

بنية الاستجابة

تتضمن الاستجابة الناجحة id وobject (chat.completion) وcreated وmodel وchoices. ويتضمن كل عنصر choice فهرسه ورسالة المساعد وfinish_reason. وقد تُعاد أعداد الرموز ضمن usage. وقد تنطبق قيود خاصة بمقدم الخدمة حتى عندما يجتاز الطلب تحقق البوابة.

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "kimi-k3.1-pro",
    "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 فتخضع للحد الشهري المنشور لها. وهذه المعلومة عن الاشتراك منفصلة عن الحدود التقنية للنموذج والجهة الوسيطة.

• تختلف نوافذ سياق النماذج والحدود القصوى للمخرجات وميزات الطلب المدعومة وضوابط الحركة المؤقتة لدى الجهات الوسيطة. راجع معلومات مقدم الخدمة والنموذج قبل إرسال حركة إنتاج.
• تخضع نقطة النهاية لتحديد معدل على مستوى التطبيق قدره 60 طلباً في الدقيقة لكل هوية تحديد معدل منطبقة. وقد يشير HTTP 429 أيضاً إلى ضوابط حركة مؤقتة لدى جهة وسيطة؛ خفّض المعدل وأعد المحاولة مع تراجع زمني بدلاً من إعادة المحاولة المتقاربة.
• استخدم HTTPS، وأبقِ المفاتيح على الخادم، وامنح نطاق الاستدلال المطلوب فقط، وألغِ المفتاح سريعاً إذا احتمل انكشافه.
• تدعم Chat Completions النص المتزامن. ويدعم Claude Messages على نحو منفصل كتل المحتوى الأصلية والأدوات وSSE عندما يسمح النموذج المحدد بذلك. ولا تشمل هذه العقود نقاط نهاية أخرى لمقدمي الخدمة.

متطلبات الوصول إلى مقدم الخدمة والحساب

صادق باستخدام مفتاح API للعميل ذي نطاق ai:inference والتابع لحساب يملك إمكانية الوصول إلى هذه الخدمة. يوضح الكتالوج ما إذا كان يُسمح حالياً للعملاء الجدد. لكنه لا يمنح الوصول ولا ينشئ اشتراكاً ولا يتجاوز أذونات الحساب والمفتاح.

الأخطاء واستكشاف المشكلات

تُعاد إخفاقات التحقق ونتائج مقدم الخدمة غير الصالحة للاستخدام عبر نقطة النهاية ضمن كائن خطأ JSON يحتوي على message وtype وcode؛ وقد تتضمن إخفاقات التحقق أيضاً تفاصيل الحقول. لا ترسل مفاتيح API أو محتوى المطالبات الخاصة في تذاكر الدعم.

تُعاد أخطاء التحقق من الطلب وإخفاقات مقدم الخدمة الناتجة عن عملية المحادثة ضمن كائن خطأ. وقد تعيد برمجيات المصادقة والنطاق وتحديد المعدل بدلاً من ذلك حقلاً message على المستوى الأعلى. افحص الحالة ومتن الاستجابة معاً.

الأسئلة الشائعة