连接信息
所有开发者和企业用户都通过 Nexus of Mind and Data 的正式域名接入。不要把 Agnes 或 DeepSeek 的供应商地址配置到你的应用中。
https://nmd.garden/v1POST /v1/chat/completionsPOST /v1/images/generationsGET /v1/models- 1注册并登录控制台
进入控制台创建平台账户。你不需要单独注册 Agnes 或 DeepSeek 账号。
- 2创建 NMD API Key
按项目设置模型范围、独立额度、到期时间和 IP 白名单。
- 3配置 Base URL
SDK 使用
https://nmd.garden/v1；直接 HTTP 请求使用下方完整端点。 - 4填写真实模型 ID
模型名称区分大小写，必须使用本页模型表中的 ID。
认证与 API Key
每次请求都必须在 HTTP Header 中携带 NMD API Key。密钥用于识别账户、模型权限和可用余额。
Authorization: Bearer YOUR_NMD_API_KEY
只在服务端环境变量中保存密钥。不要写入浏览器代码、移动端安装包、公开仓库或截图。
NEXUS_API_KEY=sk-your-nmd-api-key当前开放模型
以下是平台当前可以通过 API 调用的准确模型名称。模型 ID 应原样填写在请求体的 model 字段中。
| 供应商 | 模型 ID | 能力 | 上下文 / 规格 | 端点 | 平台价格 |
|---|---|---|---|---|---|
| Agnes AI | agnes-1.5-flash | 文本 | 官方未披露 | Chat Completions | $1 输入 / $2 输出 |
| Agnes AI | agnes-2.0-flash | 文本、视觉、工具 | 512K / 65.5K 输出 | Chat Completions | $2 输入 / $3 输出 |
| Agnes AI | agnes-image-2.0-flash | 图像生成、编辑 | 精确像素尺寸 | Images Generations | 当前免费 |
| Agnes AI | agnes-image-2.1-flash | 高密度图像 | 1K - 4K + 比例 | Images Generations | 当前免费 |
| DeepSeek | deepseek-v4-flash | 文本、推理、工具 | 1M / 384K 输出 | Chat Completions | 输入免费 / $0.5 输出 |
| DeepSeek | deepseek-v4-pro | 复杂推理、Agent | 1M / 384K 输出 | Chat Completions | 输入免费 / $1 输出 |
不要使用旧别名。平台不开放 deepseek-chat 和 deepseek-reasoner，请直接使用 deepseek-v4-flash 或 deepseek-v4-pro。
调用对话 API
四个文本模型共用同一个 OpenAI 兼容端点。切换供应商时只需修改 model，无需更换 Base URL 或 API Key。
第一次调用
curl https://nmd.garden/v1/chat/completions \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-2.0-flash",
"messages": [
{"role": "system", "content": "你是一名专业的开发助手。"},
{"role": "user", "content": "用三句话解释什么是 MaaS。"}
],
"stream": false
}'API 本身不自动保存会话。多轮调用时，应把前序的 user 和 assistant 消息追加到 messages 后再次发送。官网对话台的历史保存是平台应用功能，与公开 API 的无状态协议分开。
Agnes 文本与视觉模型
agnes-2.0-flash 适用于对话、代码、Agent、工具调用和图片理解；支持文本与公开图片 URL 混合输入。agnes-1.5-flash 使用相同对话端点，适合基础文本任务，但供应商尚未公开完整上下文规格。
图片理解
curl https://nmd.garden/v1/chat/completions \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-2.0-flash",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "描述这张图片并提取其中的文字。"},
{"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]
}]
}'开启 Thinking
使用 OpenAI 兼容格式时，将 enable_thinking 放入 chat_template_kwargs。普通对话无需开启；复杂代码、推理和 Agent 任务可按需开启。
{
"model": "agnes-2.0-flash",
"messages": [{"role": "user", "content": "分析这个代码问题并给出修复方案。"}],
"chat_template_kwargs": {
"enable_thinking": true
}
}- 图片必须是模型服务可以直接访问的公网 HTTPS URL。
- 流式响应使用
stream: true，文本内容位于增量字段choices[0].delta.content。 - 工具调用使用标准
tools与tool_choice字段。
DeepSeek V4 Flash 与 Pro
两种模型均支持 1M 上下文、最长 384K 输出、JSON Output、Tool Calls 和思考模式。Flash 适合高吞吐通用任务，Pro 适合复杂推理、代码与 Agent 工作流。
curl https://nmd.garden/v1/chat/completions \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [
{"role": "system", "content": "你是一名严谨的软件架构师。"},
{"role": "user", "content": "设计一个高可用的任务调度系统。"}
],
"thinking": {"type": "enabled"},
"reasoning_effort": "high",
"stream": false
}'{"type":"enabled"} 开启，{"type":"disabled"} 关闭；默认开启JSON Output
设置 response_format.type=json_object，并在 system 或 user 提示词中明确包含“JSON”及预期结构。请设置足够的 max_tokens，避免输出被截断。
{
"model": "deepseek-v4-flash",
"messages": [
{"role": "system", "content": "始终输出合法 JSON。"},
{"role": "user", "content": "用 JSON 返回三个 MaaS 应用场景。"}
],
"response_format": {"type": "json_object"},
"thinking": {"type": "disabled"},
"max_tokens": 1024
}工具调用与思考内容：如果一次思考模式回复包含工具调用，后续请求必须完整回传该 assistant 消息的 reasoning_content，否则上游可能返回 400。
Agnes 图像生成与编辑
两个图像模型都使用 POST https://nmd.garden/v1/images/generations。2.0 支持文生图、图生图和多图合成；2.1 更适合复杂构图与高信息密度视觉内容。
Agnes Image 2.0 Flash
curl https://nmd.garden/v1/images/generations \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-image-2.0-flash",
"prompt": "白色摄影棚中的透明玻璃立方体，柔和阴影，产品摄影",
"size": "1024x1024",
"extra_body": {
"response_format": "url"
}
}'Agnes Image 2.1 Flash
curl https://nmd.garden/v1/images/generations \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-image-2.1-flash",
"prompt": "信息密度高的未来城市交通信息图，清晰标注，精细构图",
"size": "2K",
"ratio": "16:9",
"extra_body": {
"response_format": "url"
}
}'图生图与图像编辑
{
"model": "agnes-image-2.0-flash",
"prompt": "将背景替换为白色摄影棚，保留主体构图",
"size": "1024x1024",
"extra_body": {
"image": ["https://example.com/source.png"],
"response_format": "url"
}
}response_format不能放在请求体顶层，必须放入extra_body。- 2.0 常用精确尺寸包括
1024x768、1024x1024和768x1024。 - 2.1 推荐使用
1K、2K、3K、4K，并通过ratio设置比例。 - 图生图输入放入
extra_body.image数组，支持公网 URL 或 Data URI Base64。 - URL 输出读取
data[0].url；Base64 输出将格式设为b64_json。
响应、Token 与计费
非流式对话内容位于 choices[0].message.content。每次响应的 usage 记录输入、输出和总 Token；平台根据实际用量和模型公开价格扣减账户余额。
{
"id": "chatcmpl_xxx",
"model": "agnes-2.0-flash",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "..."},
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 35,
"completion_tokens": 58,
"total_tokens": 93
}
}