文本生成与对话

使用 Nex N2.6 完成一次文本生成。三个协议示例使用同一个模型和提示词。已有 SDK 时选对应协议，首次接入可以从 Chat Completions 开始。

准备 API Key 与模型

Nex N2.6 限时免费，调用消耗 0 积分。所有有效的MOSS API Key 均可调用。生产 HTTP 请求使用 https://api.mosi.cn。运行下方示例前，将 MOSS_API_ORIGIN 设为 https://api.mosi.cn，将 MOSS_API_KEY 设为你的MOSS API Key。OpenAI SDK 的 base_url 填 https://api.mosi.cn/v1。

日常调用用 nex-n2.6，固定版本用 nex-n2.6-2026-11-05。version 可省略。显式传入时使用 2026-11-05，须与 model 指定的快照一致。

获取 API Key

选择协议

已有客户端	接口	鉴权
OpenAI Chat Completions 或首次接入	POST /v1/chat/completions	`Authorization: Bearer <API Key>`
OpenAI Responses	POST /v1/responses	`Authorization: Bearer <API Key>`
Anthropic Messages	POST /v1/messages	`x-api-key` 与 `anthropic-version: 2023-06-01`

发送第一个请求

选择一种协议发送请求。三个示例使用相同的提示词，请按对应协议读取回复。

Chat Completions

任选一种语言执行。Python 示例使用 requests，TypeScript 示例使用支持 fetch 的 Node.js 环境。

curl -X POST "$MOSS_API_ORIGIN/v1/chat/completions" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -d '{
  "model": "nex-n2.6",
  "messages": [
    {
      "role": "user",
      "content": "只回答 17 × 23 的结果。"
    }
  ],
  "max_tokens": 1024
}'

import os
import requests

url = os.environ["MOSS_API_ORIGIN"].rstrip("/") + "/v1/chat/completions"
headers = {
    "Content-Type": 'application/json',
    "Authorization": "Bearer " + os.environ["MOSS_API_KEY"],
}

payload = {'model': 'nex-n2.6',
 'messages': [{'role': 'user', 'content': '只回答 17 × 23 的结果。'}],
 'max_tokens': 1024}

response = requests.post(url, headers=headers, json=payload, timeout=(10, 120))
response.raise_for_status()
print(response.text)

async function main() {
  const origin = process.env.MOSS_API_ORIGIN;
  if (!origin) throw new Error("Set MOSS_API_ORIGIN");
  const url = origin.replace(/\/+$/, "") + "/v1/chat/completions";
  const apiKey = process.env.MOSS_API_KEY;
  if (!apiKey) throw new Error("Set MOSS_API_KEY");
  const headers: Record<string, string> = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + apiKey,
  };

  const payload = {
    "model": "nex-n2.6",
    "messages": [
      {
        "role": "user",
        "content": "只回答 17 × 23 的结果。"
      }
    ],
    "max_tokens": 1024
  };

  const response = await fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(payload),
  });
  if (!response.ok) {
    throw new Error("HTTP " + response.status + ": " + await response.text());
  }
  console.log(await response.text());
}

main().catch((error: unknown) => {
  console.error(error);
  process.exitCode = 1;
});

从 choices[0].message.content 读取回复。

Responses

curl -X POST "$MOSS_API_ORIGIN/v1/responses" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -d '{
  "model": "nex-n2.6",
  "input": "只回答 17 × 23 的结果。",
  "max_output_tokens": 1024,
  "store": false
}'

import os
import requests

url = os.environ["MOSS_API_ORIGIN"].rstrip("/") + "/v1/responses"
headers = {
    "Content-Type": 'application/json',
    "Authorization": "Bearer " + os.environ["MOSS_API_KEY"],
}

payload = {'model': 'nex-n2.6',
 'input': '只回答 17 × 23 的结果。',
 'max_output_tokens': 1024,
 'store': False}

response = requests.post(url, headers=headers, json=payload, timeout=(10, 120))
response.raise_for_status()
print(response.text)

async function main() {
  const origin = process.env.MOSS_API_ORIGIN;
  if (!origin) throw new Error("Set MOSS_API_ORIGIN");
  const url = origin.replace(/\/+$/, "") + "/v1/responses";
  const apiKey = process.env.MOSS_API_KEY;
  if (!apiKey) throw new Error("Set MOSS_API_KEY");
  const headers: Record<string, string> = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + apiKey,
  };

  const payload = {
    "model": "nex-n2.6",
    "input": "只回答 17 × 23 的结果。",
    "max_output_tokens": 1024,
    "store": false
  };

  const response = await fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(payload),
  });
  if (!response.ok) {
    throw new Error("HTTP " + response.status + ": " + await response.text());
  }
  console.log(await response.text());
}

main().catch((error: unknown) => {
  console.error(error);
  process.exitCode = 1;
});

在 output 中找到 type 为 message 的项，再从其中 type 为 output_text 的内容块读取 text。检查 status。completed 表示正常完成，incomplete 时读取已生成的内容和可用的 usage。

Messages

curl -X POST "$MOSS_API_ORIGIN/v1/messages" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $MOSS_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
  "model": "nex-n2.6",
  "messages": [
    {
      "role": "user",
      "content": "只回答 17 × 23 的结果。"
    }
  ],
  "max_tokens": 1024
}'

import os
import requests

url = os.environ["MOSS_API_ORIGIN"].rstrip("/") + "/v1/messages"
headers = {
    "Content-Type": 'application/json',
    "x-api-key": os.environ["MOSS_API_KEY"],
    "anthropic-version": '2023-06-01',
}

payload = {'model': 'nex-n2.6',
 'messages': [{'role': 'user', 'content': '只回答 17 × 23 的结果。'}],
 'max_tokens': 1024}

response = requests.post(url, headers=headers, json=payload, timeout=(10, 120))
response.raise_for_status()
print(response.text)

async function main() {
  const origin = process.env.MOSS_API_ORIGIN;
  if (!origin) throw new Error("Set MOSS_API_ORIGIN");
  const url = origin.replace(/\/+$/, "") + "/v1/messages";
  const apiKey = process.env.MOSS_API_KEY;
  if (!apiKey) throw new Error("Set MOSS_API_KEY");
  const headers: Record<string, string> = {
    "Content-Type": "application/json",
    "x-api-key": apiKey,
    "anthropic-version": "2023-06-01",
  };

  const payload = {
    "model": "nex-n2.6",
    "messages": [
      {
        "role": "user",
        "content": "只回答 17 × 23 的结果。"
      }
    ],
    "max_tokens": 1024
  };

  const response = await fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(payload),
  });
  if (!response.ok) {
    throw new Error("HTTP " + response.status + ": " + await response.text());
  }
  console.log(await response.text());
}

main().catch((error: unknown) => {
  console.error(error);
  process.exitCode = 1;
});

遍历 content 数组，读取 type 为 text 的内容块。可先用 Count Tokens 估算输入用量，生成计量以响应 usage 为准。

开启流式与继续对话

在对应请求体加入 stream: true，并给 curl 加 -N 以便及时看到增量。先检查 HTTP 状态码。流开始后仍需检查错误事件和正常结束标记，连接提前断开时按未完整返回处理。

协议	文本增量	结束与用量
Chat Completions	`choices[].delta.content`	收到 `[DONE]` 后结束。传入 `stream_options.include_usage` 获取流末用量。
Responses	`response.output_text.delta` 的 `delta`	正常结束为 `response.completed`，用量在 `response.usage`。收到 `response.incomplete` 时保留已有输出及用量。
Messages	`content_block_delta` 中的 `text_delta`	收到 `message_stop` 后结束。用量见 `message_start` 和 `message_delta`。

继续对话时，Chat Completions 和 Messages 将所需历史随 messages 传入。Responses 将历史随 input 传入，保持无状态调用。

媒体、工具与模型版本

三个生成协议均支持文本和图片。Chat Completions 和 Responses 视频通过 video_url 传入，支持 MP4、WebM。Messages 不支持视频。暂不支持文件、file_id 或资产库引用。公网媒体地址须能被 MOSS API 访问。媒体编码后的完整请求体不得超过 10 MiB。Chat Completions 和 Messages 的函数由客户端执行并回传结果。