機能

どのモデルも、同じ三つのエンドポイントに同じキーでアクセスします。二つの表は、モデル間の違いを示しています。ダッシュは、そのモデルがその機能なしで応答することを意味します。

Shannon モデル

ホスト型オープンウェイトモデル

ホスト型モデルの ID は、名前とバリアントをハイフンでつないだもので、たとえば DeepSeek-V4-Pro-0813-3BIT-REAP です。

各列の意味

• ツール. tools で関数を記述すると、モデルは実行してほしい呼び出しを返し、お使いのコードがそれを実行します。すべてのモデルがツールに対応しています。強制の tool_choice は、ホスト型オープンウェイトモデルで適用されます。 関数呼び出し
• 画像入力. モデルは、ユーザーメッセージ内で、データ URL またはアドレスとして送信された画像を読み取ります。shannon-2-lite と shannon-2-pro は、tools や response_format も送信するリクエストで画像を読み取ります。Shannon 3 ファミリーはドキュメントも読み取ります。 画像とファイル
• 推論. 応答には、回答とは別の専用フィールドに、モデルの推論テキストが含まれることがあります。 推論 effort
• 推論 effort. リクエストのフィールドで、モデルがどれだけ深く推論するかを指定します：off、low、medium、high。Shannon モデルは自分で深さを決めます。 推論 effort
• JSON オブジェクト. response_format: {"type": "json_object"} を指定すると、回答は決まった形のない JSON になります。/v1/chat/completions と /v1/responses で利用できます。 構造化出力
• JSON スキーマ. response_format にタイプ json_schema を指定すると、回答は送信したスキーマに従います。/v1/chat/completions と /v1/responses で利用できます。 構造化出力
• プロンプトキャッシュ. 同じモデルで直近のプロンプトと同じ書き出しで始まるプロンプトは、キャッシュから読み取られ、キャッシュされた部分は入力価格の 25% で課金されます。リクエストのフィールドは不要です。 プロンプトキャッシュ
• ウェブ検索. web_search: true を指定すると、API がウェブを検索し、回答前にその結果をモデルに渡します。/v1/chat/completions と /v1/messages で利用できます。これはリクエストのフィールドであり、GET /v1/models にフラグはありません。 内蔵Web検索
• ストリーミング. stream: true を指定すると、モデルが書いている間、応答が server-sent events として届きます。すべてのモデルが三つのエンドポイントすべてでストリーミングできます。 ストリーミング

GET /v1/models で得られる同じ情報

GET https://api.shannon-ai.com/v1/models

GET /v1/models は、すべてのモデルを capabilities オブジェクト付きで一覧表示するため、プログラムはこのページの代わりにそれらの情報を読み取れます。このエンドポイントにキーは不要です。

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });

for await (const model of client.models.list()) {
  console.log(model.id, model.capabilities);
}

curl https://api.shannon-ai.com/v1/models

data の二つのエントリの id と capabilities：

[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]

• response_format と prompt_caching は、ホスト型オープンウェイトのエントリのフラグです。Shannon のエントリは、JSON 出力を json_schema だけで報告し、これが両方の JSON モードを表します。
• shannon-2-lite と shannon-2-pro では vision が true です。これらは、tools や response_format も送信するリクエストで画像を読み取ります。

モデルの行にない機能

ホスト型オープンウェイトモデルは、その行に含まれない画像や JSON モードを拒否します。この拒否は、残高から何かが引かれる前に行われます。

Shannon モデルはこのようなリクエストにステータス 200 で応答します。その行にない機能は、回答には反映されません。 エラー処理