创建对话补全

创建一个对话补全请求，模型将根据输入的消息列表生成回复。

content 字段说明

content 字段支持以下两种形式：纯文本字符串

"content": "你好"

对象数组（用于多模态输入）数组中每个元素通过 type 字段区分类型：

"content": [
    { "type": "text", "text": "描述这张图片" },
    { "type": "image_url", "image_url": { "url": "data:image/png;base64,..." } },
    { "type": "video_url", "video_url": { "url": "data:video/mp4;base64,..." } }
]

其中 image_url 和 video_url 也支持直接传入字符串，效果等同于对象形式中的 url 字段：

{ "type": "image_url", "image_url": "data:image/png;base64,..." }

参数说明

数组中每个元素的字段说明如下：

参数名称	是否必须	说明	类型
`type`	required	内容类型	`"text"` \| `"image_url"` \| `"video_url"`
`text`	当 `type=text` 时必填	文本内容	string
`image_url`	当 `type=image_url` 时必填	用于传输图片，支持对象形式 `{"url": "..."}` 或直接传入 URL 字符串	object \| string
`video_url`	当 `type=video_url` 时必填	用于传输视频，支持对象形式 `{"url": "..."}` 或直接传入 URL 字符串	object \| string

当 image_url 传入对象时，其字段说明如下：

参数名称	是否必须	说明	类型
`url`	required	使用 base64 编码或通过 file id 指定的图片内容	string

当 video_url 传入对象时，其字段说明如下：

参数名称	是否必须	说明	类型
`url`	required	使用 base64 编码或通过 file id 指定的视频内容，例如 `data:video/mp4;base64,...`	string

无论使用对象形式（url 字段）还是字符串简写，均支持以下两种格式：

base64 编码：data:image/png;base64,... 或 data:video/mp4;base64,...
文件引用：ms://<file_id>

详见使用 Kimi 视觉模型。

调用示例

import os
import base64

from openai import OpenAI
from openai.types.chat import ChatCompletion

client: OpenAI = OpenAI(
    api_key=os.environ.get("MOONSHOT_API_KEY"),
    base_url="https://api.moonshot.cn/v1",
)

# 对图片进行 base64 编码
with open("您的图片地址", "rb") as f:
    img_base: str = base64.b64encode(f.read()).decode("utf-8")

response: ChatCompletion = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/jpeg;base64,{img_base}",
                    },
                },
                {
                    "type": "text",
                    "text": "请描述这个图片",
                },
            ],
        }
    ],
)
print(response.choices[0].message.content)

响应格式

非流式响应

{
    "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6",
    "object": "chat.completion",
    "created": 1698999496,
    "model": "kimi-k2.6",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "你好，李雷！1+1等于2。如果你有其他问题，请随时提问！"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 19,
        "completion_tokens": 21,
        "total_tokens": 40,
        "cached_tokens": 10
    }
}

流式响应

data: {"id":"cmpl-xxx","object":"chat.completion.chunk","created":1698999575,"model":"kimi-k2.6","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"cmpl-xxx","object":"chat.completion.chunk","created":1698999575,"model":"kimi-k2.6","choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}

...

data: {"id":"cmpl-xxx","object":"chat.completion.chunk","created":1698999575,"model":"kimi-k2.6","choices":[{"index":0,"delta":{},"finish_reason":"stop","usage":{"prompt_tokens":19,"completion_tokens":13,"total_tokens":32}}]}

data: [DONE]

响应示例中的模型名称会根据请求中的 model 参数返回。当使用 kimi-k2.6 模型时，响应中的 "model" 字段将显示为 "kimi-k2.6"。

授权

Authorization

string

header

必填

Authorization 请求头需要一个 Bearer 令牌。使用 MOONSHOT_API_KEY 作为令牌。这是一个服务端密钥，请在 API 密钥页面生成。

请求体

application/json

kimi-k2.6
kimi-k2.5
kimi-k2
kimi-k2-thinking
moonshot-v1

messages

object[]

必填

包含迄今为止对话的消息列表。每个元素格式为 {"role": "user", "content": "你好"}。role 支持 system、user、assistant 其一，content 不得为空。content 字段可以是 string，也可以是 array[object]（用于多模态输入）

Show child attributes

model

enum<string>

默认值:kimi-k2.6

必填

模型 ID

可用选项:

kimi-k2.6

max_tokens

integer

已弃用

已弃用，请使用 max_completion_tokens

max_completion_tokens

integer

聊天补全生成的最大 Token 数量。如果不给的话，默认给一个不错的整数比如 1024。如果结果达到最大 Token 数而未结束，finish reason 将为 "length"；否则为 "stop"。此值为期望返回的 Token 长度，而非输入加输出的总长度。如果输入加 max_completion_tokens 超出模型上下文窗口，将返回 invalid_request_error。

response_format

object

控制模型输出格式。默认值为 {"type": "text"}，即纯文本输出。设置为 {"type": "json_object"} 可启用 JSON 模式，确保输出为合法 JSON 对象（需在 prompt 中引导模型输出 JSON 并指定格式）。设置为 {"type": "json_schema"} 可启用 Structured Output，按指定的 JSON Schema 约束输出结构（推荐，需配合 json_schema 字段使用）。如果您在使用 JSON Schema 时遇到校验问题，欢迎到 walle GitHub Issues (https://github.com/MoonshotAI/walle/issues) 提交反馈。

Show child attributes

stop

停用词，完全匹配时将停止输出。匹配到的词本身不会被输出。最多允许 5 个字符串，每个不超过 32 字节

stream

boolean

默认值:false

是否以流式方式返回响应，默认 false

stream_options

object

流式响应选项

Show child attributes

tools

object[]

模型可调用的工具列表

Maximum array length: 128

Show child attributes

prompt_cache_key

string

用于缓存相似请求的响应以优化缓存命中率。对于 Coding Agent，通常是代表单个会话的 session id 或 task id；退出并恢复会话时应保持不变。对于 Kimi Code Plan，此字段为必填以提高缓存命中率。对于其他多轮对话 Agent，也建议使用此字段

safety_identifier

string

用于检测可能违反使用政策的用户的稳定标识符。应为唯一标识每个用户的字符串。建议对用户名或邮箱进行哈希处理以避免发送可识别信息

thinking

object

控制 kimi-k2.6 模型是否启用思考能力，以及是否完整保留多轮对话中的 reasoning_content。可选参数，默认值为 {"type": "enabled"}。

Show child attributes

响应

聊天补全响应

string

补全结果的唯一标识符

object

string

对象类型

示例:

"chat.completion"

created

integer

补全创建时的 Unix 时间戳

model

string

用于补全的模型

choices

object[]

补全选项列表

Show child attributes

usage

object

Show child attributes

使用 API

核心能力

API Reference

文件接口

批处理接口

参数说明

调用示例

非流式响应

流式响应

授权

请求体

响应

使用 API

核心能力

API Reference

文件接口

批处理接口

​参数说明

​调用示例

​非流式响应

​流式响应

授权

请求体

响应

参数说明

调用示例

非流式响应

流式响应