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 응답을 반환합니다. SSE 스트리밍이 필요하면 stream: true를 명시하세요.

요청 필드

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만 지원됩니다. 요청마다 응답 선택 항목 하나를 반환합니다.

temperature, top_p, frequency_penalty, presence_penalty, stop 같은 공통 필드는 공통 Chat Completions를 참조하세요. 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은 사용 가능한 모델 표의 공개 모델 ID여야 합니다.
제품명, 표시명 및 별칭은 공개 모델 ID 대신 사용할 수 없습니다.
이 페이지는 POST https://api.apihop.ai/v1/chat-completions로 보내는 Chat Completions 요청에만 적용되며 OpenAI Responses나 Claude Messages에는 적용되지 않습니다.
현재 키에 보이는 모델은 GET https://api.apihop.ai/v1/models로, 현재 가격은 콘솔에서 확인하세요.