نموذج Kimi | وثائق API

# Kimi Model

Call Kimi K3 through the shared Chat Completions endpoint.

POST https://api.apihop.ai/v1/chat-completions

Kimi K3 is available through the Common Chat Completions endpoint, with both non-streaming and SSE streaming text responses.

```text
POST https://api.apihop.ai/v1/chat-completions
```

## Available Model

| `model` value | Type | Non-streaming | SSE streaming |
| --- | --- | --- | --- |
| `kimi-k3` | Text chat | Yes | Yes |

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Non-streaming Request

```json
{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "system",
      "content": "You are a product analysis assistant."
    },
    {
      "role": "user",
      "content": "Break this requirement into goals, constraints, and acceptance criteria."
    }
  ],
  "stream": false
}
```

## Streaming Request

```json
{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": "Create a pre-release checklist."
    }
  ],
  "stream": true
}
```

This endpoint returns one complete JSON response by default. Set `stream: true` explicitly when you need SSE streaming.

## Request Fields

### `model` (string, required)

Use `kimi-k3`.

### `messages` (object[], required)

OpenAI Chat Completions style messages. Each message contains `role` and `content`.

### `stream` (boolean, Default: false)

`true` returns SSE; `false` returns one complete JSON response.

### `max_tokens` (integer)

Optional output token allowance. Omit it to use the upstream default. Reasoning and the final answer share this allowance: a small value may end with `finish_reason: "length"` before any answer text is produced. A larger allowance may increase output usage and cost.

### `max_completion_tokens` (integer)

Compatibility alternative to `max_tokens`. The selected model determines support.

### `n` (integer, Default: 1)

Only `n=1` is supported. Each request returns one response choice.

See [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions) for shared fields such as `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, and `stop`. `kimi-k3` accepts these standard fields, but not every parameter necessarily produces a measurable semantic change.

## Success Response

```json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "kimi-k3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Goal: define the problem and expected outcome..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 86,
    "total_tokens": 110
  }
}
```

## Usage Notes

- The request body's `model` must be the public model ID listed in the Available Model table.
- Product names, display names, and other aliases are not accepted in place of the public model ID.
- This page applies only to Chat Completions requests sent to

`POST https://api.apihop.ai/v1/chat-completions`, not OpenAI Responses or Claude Messages.

- Use `GET https://api.apihop.ai/v1/models` for the models visible to the current API Key, and use the console for current pricing.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [Model Catalog](https://apihop.ai/en/docs/api-reference/models)

يتوفر Kimi K3 عبر نقطة نهاية Chat Completions المشتركة، باستجابات نصية دون بث وببث SSE.

text

POST https://api.apihop.ai/v1/chat-completions

النموذج المتاح

قيمة `model`	النوع	دون بث	بث SSE
`kimi-k3`	محادثة نصية	نعم	نعم

المصادقة

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

طلب دون بث

json

{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "system",
      "content": "You are a product analysis assistant."
    },
    {
      "role": "user",
      "content": "Break this requirement into goals, constraints, and acceptance criteria."
    }
  ],
  "stream": false
}

طلب بث

json

{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": "Create a pre-release checklist."
    }
  ],
  "stream": true
}

تعيد نقطة النهاية هذه استجابة JSON كاملة واحدة افتراضيا. اضبط stream: true صراحة عندما تحتاج إلى بث SSE.

حقول الطلب

modelstringمطلوب

استخدم kimi-k3.

messagesobject[]مطلوب

رسائل بأسلوب OpenAI Chat Completions. تتضمن كل رسالة role وcontent.

streambooleanالقيمة الافتراضية: false

تعيد true بث SSE؛ وتعيد false استجابة JSON كاملة واحدة.

max_tokensinteger

حصة اختيارية لرموز الإخراج. احذفها لاستخدام القيمة الافتراضية لدى المزود. يشترك الاستدلال والإجابة النهائية في هذه الحصة: قد تنتهي القيمة الصغيرة بـfinish_reason: "length" قبل إنتاج أي نص للإجابة. قد تزيد الحصة الأكبر استخدام الإخراج والتكلفة.

max_completion_tokensinteger

بديل توافق لـmax_tokens. يحدد النموذج المختار الدعم.

nintegerالقيمة الافتراضية: 1

تدعم n=1 فقط. يعيد كل طلب خيار استجابة واحدا.

راجع واجهة Chat Completions المشتركة للحقول المشتركة مثل temperature وtop_p وfrequency_penalty وpresence_penalty وstop. يقبل kimi-k3 هذه الحقول القياسية، لكن ليس كل معامل ينتج بالضرورة تغيرا دلاليا قابلا للقياس.

استجابة ناجحة

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "kimi-k3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Goal: define the problem and expected outcome..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 86,
    "total_tokens": 110
  }
}

ملاحظات الاستخدام

يجب أن تكون قيمة model في جسم الطلب معرف النموذج العام المدرج في جدول النموذج المتاح.
لا تقبل أسماء المنتجات أو أسماء العرض أو الأسماء البديلة الأخرى بدلا من معرف النموذج العام.
تنطبق هذه الصفحة فقط على طلبات Chat Completions المرسلة إلى POST https://api.apihop.ai/v1/chat-completions، وليس OpenAI Responses أو Claude Messages.
استخدم GET https://api.apihop.ai/v1/models للنماذج الظاهرة لمفتاح API الحالي، واستخدم وحدة التحكم للأسعار الحالية.