レスポンスの作成

MOSS-VL の利用方法はレスポンスの作成（VL）を参照してください。

モデル	入力	実行方式
Nex N2.6	プレーンテキストに対応。画像は`input_image`を使用し、動画は`video_url`で渡します（MP4、WebM）。`file_id`には現在対応していません。	同期またはSSEストリーミング。マルチターンの履歴はクライアントが渡します。
MOSS-VL	テキスト指示と、画像または動画の両方を指定する必要があります。メディアはURLまたは`file_id`に対応しています。	同期。

認証と接続設定

有効なMOSS APIキーであれば、どれでも呼び出せます。Authorization: Bearer <API Key>とContent-Type: application/jsonを使用します。

本番環境の HTTP リクエスト先は https://api.mosi.cn です。例を実行する前に、MOSS_API_ORIGIN に https://api.mosi.cn、MOSS_API_KEY に MOSS API キーを設定します。OpenAI SDK の base_url には https://api.mosi.cn/v1 を設定します。

リクエストパラメータ

フィールド型指定説明

model: string必須

nex-n2.6 または固定スナップショット nex-n2.6-2026-11-05 を使用します。

input: string または array必須

テキストのみの場合は文字列を渡せます。複数ターンの対話では配列に履歴を含めます。画像は input_image、MP4 または WebM の動画は video_url で指定します。

max_output_tokens: integer任意

出力トークン数の上限です。本番環境の既定値は 8,192、設定できる上限は 131,072 です。

store: boolean任意

ステートレスで呼び出すために false を指定します。

stream: boolean任意

true を指定するとストリーミング応答になります。

version: string任意

省略できます。明示する場合は 2026-11-05 を指定し、model で選択したスナップショットと一致させてください。

Responses はステートレスです。対話の履歴は input に含めます。現在、previous_response_id、conversation、background: true、サーバー側のセッション、ファイル、アセットライブラリの参照には対応していません。公開メディア URL は MOSS からアクセスできる必要があります。エンコード済みメディアを含むリクエストボディ全体は 10 MiB 以下にしてください。

レスポンスフィールド

フィールド型説明

model: string

応答の生成に使用されたモデルスナップショットです。

status: string

completed は正常終了、incomplete は出力が未完了であることを示します。

output: array<object>

message 項目の content から、type が output_text のコンテンツを読み取ります。

incomplete_details.reason: string

出力上限に達した場合は max_output_tokens が返されます。

usage: object

トークン使用量です。ストリーミングが正常終了した場合は、response.completed の response.usage から読み取ります。

終了状態

複数ターンのリクエストでは、クライアントが必要な履歴を渡します。store: false を指定し、previous_response_id は省略します。

受信した結果	クライアントの処理
`completed` / `response.completed`	正常終了です。蓄積したテキストとレスポンスに含まれる使用量を利用します。
`incomplete` / `response.incomplete`	生成済みの内容と取得可能な `usage` を保持します。理由が `max_output_tokens` の場合は、出力上限に達したことを通知するか、上限を調整して再試行します。
`error` / `response.failed`	失敗として扱います。ストリーム開始前は HTTP レスポンスを確認し、開始後は失敗イベントを処理します。

リクエスト例

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;
});

レスポンスの抜粋です。正常終了時の status は completed です。

{
  "object": "response",
  "model": "nex-n2.6-2026-11-05",
  "status": "completed",
  "usage": {
    "input_tokens": 22,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_write_tokens": 0
    },
    "output_tokens": 23,
    "output_tokens_details": {
      "reasoning_tokens": 19
    },
    "total_tokens": 45
  },
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "\n\n391"
        }
      ]
    }
  ]
}

リクエストボディに stream: true を追加します。response.output_text.delta イベントの delta を連結します。response.completed は正常終了を示します。response.incomplete を受信した場合は生成済みの内容と返された usage を保持し、error または response.failed は失敗として扱います。まず HTTP ステータスを確認し、ストリーム開始後もエラーイベントと正常終了マーカーを確認してください。途中で接続が切れた場合は、未完了の応答として扱います。

curl -N -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,
  "stream": true
}'

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,
 'stream': True}

with requests.post(url, headers=headers, json=payload, stream=True, timeout=(10, 120)) as response:
    response.raise_for_status()
    response.encoding = "utf-8"
    for line in response.iter_lines(chunk_size=1, decode_unicode=True):
        print(line, flush=True)

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,
    "stream": true
  };

  const response = await fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(payload),
  });
  if (!response.ok) {
    throw new Error("HTTP " + response.status + ": " + await response.text());
  }
  if (!response.body) throw new Error("Missing response body");
  const reader = response.body.getReader();
  const decoder = new TextDecoder();
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      process.stdout.write(decoder.decode(value, { stream: true }));
    }
    process.stdout.write(decoder.decode());
  } finally {
    reader.releaseLock();
  }
}

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

ストリーミング応答の抜粋です。正常終了時の使用量は response.completed の response.usage から読み取ります。

data: {"type":"response.output_text.delta","sequence_number":23,"output_index":1,"content_index":0,"delta":"39"}

data: {"type":"response.completed","sequence_number":28,"response":{"object":"response","model":"nex-n2.6-2026-11-05","status":"completed","usage":{"input_tokens":22,"input_tokens_details":{"cached_tokens":0,"cache_write_tokens":0},"output_tokens":18,"output_tokens_details":{"reasoning_tokens":14},"total_tokens":40},"output":[{"type":"message","role":"assistant","content":[{"type":"output_text","text":"\n\n391"}]}]}}

出力上限に達した場合のレスポンス抜粋です。テキストと使用量は実際の応答によって異なります。

{
  "status": "incomplete",
  "incomplete_details": {
    "reason": "max_output_tokens"
  }
}

max_output_tokens で出力上限を制御できます。例の 1,024 を初期値として、用途に応じて調整してください。

レスポンスの作成（Responses）

認証と接続設定

リクエストパラメータ

レスポンスフィールド

終了状態

関連ドキュメント