> For the complete documentation index, see [llms.txt](https://nsclouds.gitbook.io/aillm.nscloud.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nsclouds.gitbook.io/aillm.nscloud.ai/api-reference-cn/dui-hua-jie-kou/deepseek/messages.md).

# Messages

### 1. 概述

DeepSeek 在当前环境中提供的 Messages 协议能力。

{% hint style="success" %}
本接口提供与 Anthropic Messages 协议兼容的请求路径。具体行为以当前支持能力为准。
{% endhint %}

**模型列表：**

* `deepseek/deepseek-v3.2`
* `deepseek/deepseek-v4-flash`
* `deepseek/deepseek-v4-pro`

### 2. 接口详情

## 创建 Messages 消息

> 提供与 Anthropic Messages 协议兼容的接口。

```json
{"openapi":"3.1.0","info":{"title":"NSCloud AI API 文档","version":"1.11.0"},"tags":[{"name":"messages_deepseek","description":"DeepSeek 的 Messages 协议 API"}],"servers":[{"url":"https://aillm.nscloud.ai","description":"国际服务器"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"http","scheme":"bearer","description":"使用 Bearer 令牌进行认证，格式：'Bearer YOUR_SECRET_TOKEN'"}},"schemas":{"CreateMessagesRequest":{"type":"object","description":"Messages 协议请求体。","properties":{"model":{"type":"string","description":"要调用的模型 ID。"},"messages":{"type":"array","description":"输入消息列表。这里对内容片段保持宽松，以兼容不同厂商的协议扩展。","items":{"$ref":"#/components/schemas/MessagesRequestMessage"}},"max_tokens":{"type":"integer","description":"最大输出 token 数。"},"stream":{"type":"boolean","description":"是否以流式方式返回响应。","default":false}},"required":["model","messages"],"additionalProperties":true},"MessagesRequestMessage":{"type":"object","description":"Messages 兼容协议中的单条输入消息。","properties":{"role":{"type":"string","description":"消息角色，不同厂商支持的角色名可能不同。"},"content":{"description":"消息内容，可以是纯文本，也可以是厂商自定义的内容片段数组。","oneOf":[{"type":"string","description":"纯文本内容。"},{"type":"array","description":"结构化内容片段数组。","items":{"$ref":"#/components/schemas/MessageContentPart"}}]}},"required":["role","content"],"additionalProperties":true},"MessageContentPart":{"type":"object","description":"Messages 兼容协议使用的宽松内容片段结构。","properties":{"type":{"type":"string","description":"内容片段类型，例如 text、image、tool_use、tool_result。"},"text":{"type":"string","description":"文本内容。"},"image_url":{"type":"object","description":"OpenAI 风格的图片 URL 结构。","additionalProperties":true},"source":{"type":"object","description":"Anthropic 风格的媒体来源结构。","additionalProperties":true},"id":{"type":"string","description":"内容块或工具调用的标识符。"},"name":{"type":"string","description":"工具、函数或内容块名称。"},"input":{"type":"object","description":"工具输入参数或其他结构化内容。","additionalProperties":true},"content":{"description":"某些协议会在内容片段内部嵌套的内容，例如 tool_result。","oneOf":[{"type":"string","description":"纯文本嵌套内容。"},{"type":"array","description":"嵌套的结构化内容数组。","items":{"type":"object","additionalProperties":true}}]}},"additionalProperties":true},"MessageResponse":{"type":"object","description":"Messages 协议成功响应。","properties":{"id":{"type":"string","description":"响应唯一 ID。"},"type":{"type":"string","description":"对象类型，通常为 message。"},"role":{"type":"string","description":"返回消息的角色，通常为 assistant。"},"model":{"type":"string","description":"实际使用的模型 ID。"},"content":{"type":"array","description":"返回的内容片段列表，可能包含文本、工具调用、引用或 reasoning 块。","items":{"$ref":"#/components/schemas/MessageContentPart"}},"stop_reason":{"type":"string","description":"生成停止原因。"},"usage":{"$ref":"#/components/schemas/Usage"}},"additionalProperties":true},"Usage":{"type":"object","description":"Token 使用量统计。","properties":{"prompt_tokens":{"type":"integer","description":"输入消耗的 token 数。"},"completion_tokens":{"type":"integer","description":"输出消耗的 token 数。"},"total_tokens":{"type":"integer","description":"总 token 数。"},"input_tokens":{"type":"integer","description":"输入消耗的 token 数，部分协议使用该字段。"},"output_tokens":{"type":"integer","description":"输出消耗的 token 数，部分协议使用该字段。"},"completion_tokens_details":{"type":"object","description":"输出 token 使用明细。","properties":{"reasoning_tokens":{"type":"integer","description":"推理类输出消耗的 token 数。"}},"additionalProperties":true},"input_tokens_details":{"type":"object","description":"输入 token 使用明细。","properties":{"text_tokens":{"type":"integer","description":"文本输入消耗的 token 数。"},"image_tokens":{"type":"integer","description":"图片输入消耗的 token 数。"}},"additionalProperties":true}}},"ErrorResponse":{"type":"object","description":"错误响应。","properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}}},"ErrorDetail":{"type":"object","description":"错误详情对象。","properties":{"message":{"type":"string","description":"错误说明。"},"type":{"type":"string","description":"错误类型。"},"param":{"description":"与错误相关的参数名。","type":["string","null"]},"code":{"description":"错误码。","type":["string","null"]}}}},"responses":{"ErrorResponse":{"description":"错误响应","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/v1/messages":{"post":{"tags":["messages_deepseek"],"summary":"创建 Messages 消息","description":"提供与 Anthropic Messages 协议兼容的接口。","operationId":"createMessage_deepseek","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMessagesRequest"}}}},"responses":{"200":{"description":"成功响应","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"400":{"$ref":"#/components/responses/ErrorResponse"},"401":{"$ref":"#/components/responses/ErrorResponse"},"429":{"$ref":"#/components/responses/ErrorResponse"}}}}}}
```