From 8d06b94604caf0b6f73de073a70c0e6dba6a8aa2 Mon Sep 17 00:00:00 2001
From: Concedo <39025047+LostRuins@users.noreply.github.com>
Date: Mon, 8 Jun 2026 11:12:14 +0800
Subject: [PATCH] update docs (+1 squashed commits)

Squashed commits:

[e9cb49c52] updated docs
---
 embd_res/kcpp_docs.embd | 119 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)

diff --git a/embd_res/kcpp_docs.embd b/embd_res/kcpp_docs.embd
index dddc92921..92234c19d 100644
--- a/embd_res/kcpp_docs.embd
+++ b/embd_res/kcpp_docs.embd
@@ -2917,6 +2917,125 @@
                       "responses": {"default": {"description": ""}}
                    }
                 },
+                "/v1/messages": {
+                  "post": {
+                     "summary": "Creates a message using the Anthropic Messages API format",
+                     "description": "Given a structured list of input messages, a system prompt, and required tokens parameter, the model will return a response. This follows the native Anthropic Messages payload style.",
+                     "tags": [
+                        "v1"
+                     ],
+                     "parameters": [
+                        {
+                           "name": "x-api-key",
+                           "in": "header",
+                           "required": false,
+                           "description": "Anthropic API Key used for authentication.",
+                           "schema": {
+                              "type": "string"
+                           }
+                        },
+                        {
+                           "name": "anthropic-version",
+                           "in": "header",
+                           "required": false,
+                           "description": "Anthropic API version. Currently, '2023-06-01' is expected.",
+                           "schema": {
+                              "type": "string",
+                              "default": "2023-06-01"
+                           }
+                        }
+                     ],
+                     "requestBody": {
+                        "required": false,
+                        "content": {
+                           "application/json": {
+                              "example": {
+                                 "model": "claude-3-5-sonnet-20241022",
+                                 "max_tokens": 1024,
+                                 "system": "You are a helpful assistant.",
+                                 "messages": [
+                                    {
+                                       "role": "user",
+                                       "content": "Tell me a joke about Kobolds."
+                                    }
+                                 ],
+                                 "temperature": 0.7
+                              },
+                              "schema": {
+                                 "type": "object",
+                                 "required": [
+                                    "model",
+                                    "messages",
+                                    "max_tokens"
+                                 ],
+                                 "properties": {
+                                    "model": {
+                                       "type": "string",
+                                       "description": "The model that will handle the request."
+                                    },
+                                    "messages": {
+                                       "type": "array",
+                                       "description": "Input messages. Roles must alternate between user and assistant.",
+                                       "items": {
+                                          "type": "object",
+                                          "required": [
+                                             "role",
+                                             "content"
+                                          ],
+                                          "properties": {
+                                             "role": {
+                                                "type": "string",
+                                                "enum": ["user", "assistant"]
+                                             },
+                                             "content": {
+                                                "oneOf": [
+                                                   { "type": "string" },
+                                                   {
+                                                      "type": "array",
+                                                      "items": {
+                                                         "type": "object",
+                                                         "properties": {
+                                                            "type": {
+                                                               "type": "string",
+                                                               "enum": ["text", "image"]
+                                                            },
+                                                            "text": { "type": "string" }
+                                                         }
+                                                      }
+                                                   }
+                                                ]
+                                             }
+                                          }
+                                       }
+                                    },
+                                    "system": {
+                                       "type": "string",
+                                       "description": "System prompt to define the behavior and tone of the model."
+                                    },
+                                    "max_tokens": {
+                                       "type": "integer",
+                                       "description": "The maximum number of tokens to generate."
+                                    },
+                                    "temperature": {
+                                       "type": "number",
+                                       "minimum": 0.0,
+                                       "maximum": 1.0
+                                    },
+                                    "stream": {
+                                       "type": "boolean"
+                                    }
+                                 }
+                              }
+                           }
+                        }
+                     },
+                     "responses": {
+                        "default": {
+                           "description": ""
+                        }
+                     }
+                  }
+               }
              },
              "servers": [
                 {