Kimi K3 API: كيف تحصل على مفتاح وترسل أول استدعاء

لاستدعاء Kimi K3، تحتاج إلى مفتاح API من منصّة تقدّمه، وإلى طلب تُضبط فيه model على kimi-k3. تقدّمه Moonshot AI على منصّتها الخاصة Kimi API Platform، حيث يُفتح النموذج بعد أول شحن للرصيد. وتقدّمه SeedRouter بمفتاح واحد، بالدفع حسب الاستخدام، وبصيغة الطلبات الرسمية: وجّه OpenAI SDK إلى https://api.seedrouter.ai/v1 واحتفظ بكودك كما هو.

يستخدم هذا الدليل SeedRouter؛ ونصوص الطلبات هي نفسها في API الخاصة بـ Kimi.

كيف أحصل على مفتاح Kimi K3 API؟

1. سجّل الدخول إلى SeedRouter وافتح مفاتيح API.
2. أنشئ مفتاحًا وانسخه؛ فهو لا يظهر إلا مرة واحدة.
3. أضف رصيدًا عندما تحتاج إليه. تبدأ الحسابات الجديدة برصيد مجاني صغير، ولا يوجد اشتراك.

احفظ المفتاح في متغيّر بيئة مثل SEEDROUTER_API_KEY، ولا تستخدمه إلا من كود يعمل على الخادم.

كيف أستدعي Kimi K3 من Python؟

يتعامل Kimi K3 بصيغة Chat Completions، لذا تعمل حزمة openai الرسمية كما هي:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Explain context caching in one sentence."}],
)
print(completion.choices[0].message.content)

الإجابة موجودة في content. يستدلّ Kimi K3 قبل أن يُجيب، ويعود هذا الاستدلال في reasoning_content ضمن الرسالة نفسها.

كيف أستدعيه من Node.js أو cURL؟

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: "https://api.seedrouter.ai/v1",
});

const completion = await client.chat.completions.create({
  model: "kimi-k3",
  messages: [{ role: "user", content: "Explain context caching in one sentence." }],
});
console.log(completion.choices[0].message.content);

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "kimi-k3", "messages": [{"role": "user", "content": "Explain context caching in one sentence."}]}'

يستجيب المفتاح نفسه أيضًا لـ Responses API (/v1/responses) ولصيغة Anthropic Messages (/v1/messages) مع kimi-k3.

كيف أضبط مستوى الاستدلال؟

يستدلّ Kimi K3 دائمًا، ولا يمكنك إيقاف ذلك. يحدّد reasoning_effort مقدار ما يفكّر فيه قبل أن يُجيب:

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Find the bug: def avg(xs): return sum(xs) / len(xs)"}],
    reasoning_effort="high",
)

تُحتسب توكنات الاستدلال كإخراج وتُعدّ ضمن max_completion_tokens، الذي تبلغ قيمته الافتراضية 131,072 ويصل حتى 1,048,576. في اختبارنا على السؤال نفسه، استخدم low عدد 25 توكن إخراج واستخدم max عدد 146.

كيف أبثّ الإجابة؟

أضف stream=True. يصل الاستدلال أولًا في delta.reasoning_content، ثم الإجابة في delta.content. اطلب stream_options={"include_usage": True} لتحصل على أعداد التوكنات في آخر جزء:

stream = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Write a haiku about latency."}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

هل يمكنني إرسال صور؟

نعم، بصيغة data URI مرمّزة بـ base64. لا يقبل Kimi K3 روابط صور عامة؛ إذ يقول دليل البدء السريع الخاص به: "Vision input does not support public image URLs" (إدخال الرؤية لا يدعم روابط الصور العامة):

import base64

with open("chart.png", "rb") as f:
    image = base64.b64encode(f.read()).decode()

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/png;base64,{image}"}},
            {"type": "text", "text": "What does this chart show?"},
        ],
    }],
)

ما الأخطاء التي قد أواجهها؟

تعود الأخطاء بصيغة {"error": {"code": ..., "message": "..."}}، والطلب الذي يفشل لا يُحتسب.

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

هل Kimi K3 API متوافقة مع OpenAI؟

نعم. يقبل Kimi K3 صيغتَي Chat Completions و Responses، لذا يعمل OpenAI SDK بعد تغيير عنوان URL الأساسي واسم النموذج فقط. ويقبل أيضًا صيغة Anthropic Messages.

هل أحتاج إلى حساب Moonshot لاستخدام Kimi K3؟

ليس على SeedRouter. تسجّل الدخول إلى SeedRouter، وتُنشئ مفتاحًا هناك، وتدفع من رصيدك على SeedRouter.

كم يكلّف طلب Kimi K3 واحد؟

يُحتسب لكل توكن إدخال وإخراج. يعرض دليل أسعار Kimi K3 الأسعار المباشرة وأمثلة محسوبة.

أين أجد قائمة المعاملات الكاملة؟

يسرد مرجع Kimi K3 API كل حقل، وتوفّر صفحة Kimi K3 ساحة اللعب والأسعار المباشرة.