Chat Completions API

POST

/v1/chat/completions

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "model": "kimi-k3",
    "messages": [
        {
            "role": "system",
            "content": "string",
            "name": "string",
            "partial": false,
            "tool_call_id": "string",
            "tool_calls": [
                {
                    "id": "string",
                    "type": "function",
                    "function": {
                        "name": "string",
                        "arguments": "string"
                    }
                }
            ],
            "reasoning_content": "string"
        }
    ],
    "max_completion_tokens": 0,
    "temperature": 0,
    "top_p": 1,
    "n": 1,
    "presence_penalty": 0,
    "frequency_penalty": 0,
    "response_format": {
        "type": "text",
        "json_schema": {
            "name": "string",
            "strict": true,
            "schema": {
                "property1": "string",
                "property2": "string"
            }
        }
    },
    "stop": "string",
    "stream": false,
    "stream_options": {
        "include_usage": false
    },
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "string",
                "description": "string",
                "parameters": {
                    "property1": "string",
                    "property2": "string"
                },
                "strict": true
            }
        }
    ],
    "tool_choice": "auto",
    "thinking": {
        "type": "enabled",
        "keep": "all"
    },
    "reasoning_effort": "max",
    "logprobs": false,
    "top_logprobs": 0,
    "prediction": {
        "type": "content",
        "content": "string"
    },
    "prompt_cache_key": null,
    "safety_identifier": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/chat/completions' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "kimi-k3",
    "messages": [
        {
            "role": "system",
            "content": "string",
            "name": "string",
            "partial": false,
            "tool_call_id": "string",
            "tool_calls": [
                {
                    "id": "string",
                    "type": "function",
                    "function": {
                        "name": "string",
                        "arguments": "string"
                    }
                }
            ],
            "reasoning_content": "string"
        }
    ],
    "max_completion_tokens": 0,
    "temperature": 0,
    "top_p": 1,
    "n": 1,
    "presence_penalty": 0,
    "frequency_penalty": 0,
    "response_format": {
        "type": "text",
        "json_schema": {
            "name": "string",
            "strict": true,
            "schema": {
                "property1": "string",
                "property2": "string"
            }
        }
    },
    "stop": "string",
    "stream": false,
    "stream_options": {
        "include_usage": false
    },
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "string",
                "description": "string",
                "parameters": {
                    "property1": "string",
                    "property2": "string"
                },
                "strict": true
            }
        }
    ],
    "tool_choice": "auto",
    "thinking": {
        "type": "enabled",
        "keep": "all"
    },
    "reasoning_effort": "max",
    "logprobs": false,
    "top_logprobs": 0,
    "prediction": {
        "type": "content",
        "content": "string"
    },
    "prompt_cache_key": null,
    "safety_identifier": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "assistant",
        "content": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "reasoning_content": "<string>"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "cached_tokens": 123
  }
}

修改于 2026-08-20 07:41:42

工具调用

简单对话