変更履歴
Shannon API の最近の更新と改善点です。
このページには、API の利用者として確認できる変更(新しいエンドポイント、フィールド、モデル、動作の変更、修正)を一覧にしています。新しいエントリが先頭です。各エントリには、変更が行われた日付が付いています。
破壊的変更 と記されたエントリは、以前は動作していたリクエストの結果を変える可能性があります。API のバージョンは /v1 ただひとつのため、変更はバージョン番号ではなく日付順に記載しています。
- 新規
web_search: trueを指定したリクエストは、ソースを明示します。/v1/chat/completionsと/v1/messagesではsourcesがモデルに渡された結果を一覧にし、/v1/chat/completionsではannotationsが回答の中でそれぞれを引用している位置を示します。 内蔵Web検索
- 新規
/v1/chat/completionsと/v1/messagesでweb_search: trueを指定すると、モデルが回答する前にウェブ検索を実行し、結果を番号付きのソースとして渡します。結果が見つかったリクエストは、日次枠の一回分の検索を消費します。枠が残っていない場合は、検索なしで応答します。 内蔵Web検索
- 修正
サーバー側で打ち切られたストリームは、その時点までに報告された使用量が課金されます。確保していた残りは残高に戻ります。
- 修正
shannon-coder-1が、他の二つのエンドポイントと同様に/v1/responsesでも応答します。 CLI コーディングツール - 修正
ローテーションされた API キーはただちに使えなくなります。
- 新規
POST /v1/tokenizeとPOST /v1/messages/count_tokens:ホスト型オープンウェイトモデル向けの無料のトークンカウント。 トークンカウント - 新規
ホスト型オープンウェイトモデルでプロンプトキャッシュに対応。キャッシュ済み入力は入力価格の 25% で課金され、三つのエンドポイントすべての
usageに報告されます:prompt_tokens_details.cached_tokens、input_tokens_details.cached_tokens、cache_read_input_tokens。GET /v1/modelsは、これらのモデルについてpricing.cached_input_per_million_usdとcapabilities.prompt_cachingを報告します。 プロンプトキャッシュ - 修正
ホスト型オープンウェイトモデル:強制の
tool_choice(requiredまたは名前付き関数)はツール呼び出しを返します。 関数呼び出し - 修正
ホスト型オープンウェイトモデルは、会話の最初のメッセージではない
systemメッセージを受け付けます。
- 新規
API は Tor の onion サービスと I2P アドレスで到達できます。
api.shannon-ai.comの応答は、Onion-LocationヘッダーとX-I2P-Locationヘッダーに二つのアドレスを含みます。 暗号化・Tor・I2P エンドポイント
- 新規
新しいモデル
shannon-3.1とshannon-3.1-pro。GET /v1/modelsに表示されます。 モデルと料金 - 変更
クライアントが切断したストリームリクエストも最後まで実行され、計上されます。以前は、切断した時点で回答が止まっていました。
- 修正
/v1/responsesへのリクエストが使用量ログに表示されます。
- 新規
ホスト型オープンウェイトモデルがサンプリングフィールドを適用します:
/v1/chat/completionsではtemperature、top_p、seed、stop、max_tokens、/v1/messagesではtemperature、top_p、stop_sequences、/v1/responsesではtemperature、top_p、max_output_tokens。 Chat Completions - 新規
使用量ログに、呼び出しごと、および合計の USD 建てコストが表示されます。
- 破壊的変更
公開されている ID ではない
modelの値には、三つのエンドポイントすべてで、400、タイプinvalid_request_error、メッセージunknown model: <id>で応答します。以前は、そのようなリクエストにはshannon-1.6-liteが応答していました。 モデルと料金 - 破壊的変更
/v1は API キーのみを受け付けます。ウェブサイトのサインイン用クッキーは読み取られません。 認証 - 変更
フラッド保護:三つの生成エンドポイントで、アカウントあたり一分間に 120 リクエスト。 上限と残高
- 改善
モデルが応答できない場合、エラーには固定メッセージ
The model backend failed to answer. Please retry.が含まれます。残高の確認ができない場合は、503とタイプapi_errorで応答します。 エラー処理 - 修正
失敗した非ストリームリクエストは、確保していた分を残高に戻します。
- 新規
GET /v1/modelsが各モデルのcapabilities.reasoning_effortを報告します。 推論 effort - 改善
ホスト型オープンウェイトモデル:応答が得られない非ストリームリクエストは、
504とタイプapi_errorで終了します。結果が空の場合は502です。 エラー処理
- 破壊的変更
ホスト型オープンウェイトモデルは、指定されたモデルが受け付ける入力を受け付けます。テキスト専用の ID に画像を送信すると、
400と<id> does not accept image inputで応答します。構造化出力のない ID にresponse_formatを送信した場合も400で応答します。GET /v1/modelsは、各 ID についてcapabilities.vision、response_format、json_schemaを報告します。 画像とファイル - 修正
非ストリーム応答にも推論テキストが含まれます:
/v1/chat/completionsではメッセージのreasoning_content、/v1/messagesではテキストの前のthinkingブロック。 推論 effort - 変更
ホスト型オープンウェイトモデルの価格を改定しました。入力 1M トークンあたり $0.50 から、出力 1M トークンあたり $2.00 からです。 モデルと料金
- 変更
ホスト型オープンウェイトモデルは、モデルごとにひとつの ID を持ち、合計で十二個の ID があります。 モデルと料金
- 新規
shannon-3、shannon-3-pro、shannon-3.1、shannon-3.1-proで構造化出力に対応。GET /v1/modelsはこれらについてcapabilities.json_schema: trueを報告します。 構造化出力 - 新規
/v1/responsesは、構造化出力のためにtext.format(json_objectまたはjson_schema)を読み取ります。 Responses API - 修正
/v1/responsesが Shannon モデルの推論を返します:messageアイテムの前にreasoning出力アイテム、ストリームイベントはresponse.reasoning_summary_text.deltaとresponse.reasoning_summary_text.done。 Responses API - 修正
応答の
modelフィールドは、すべてのエンドポイントで公開されている ID になります。Responses オブジェクトにはmodelとcreated_atが含まれます。 - 改善
GET /v1/modelsが各モデルのコンテキストウィンドウを報告します。 モデルと料金
- 新規
ホスト型オープンウェイトモデルは、
/v1/chat/completionsに加えて/v1/messagesと/v1/responsesでも、システムプロンプトとツール呼び出しに対応して応答します。/v1/messagesはthinkingを受け付け、reasoning_effortはリクエストのフィールドです。 モデルと料金 - 改善
/v1のエラーボディは SDK の形式に従います。OpenAI 形式のエンドポイントではtypeとmessageを持つerrorオブジェクト、/v1/messagesでは同じオブジェクトを{"type": "error"}の中に入れた形式です。 エラー処理 - 新規
開いているストリームで 15 秒ごとにキープアライブを送信:
/v1/chat/completionsでは: pingコメント行、/v1/messagesではevent: ping。 ストリーミング - 変更
ツール呼び出し ID は、
/v1/chat/completionsと/v1/responsesではcall_、/v1/messagesではtoolu_で始まります。 関数呼び出し - 破壊的変更
/v1/responses:streamのデフォルトはfalseです。 Responses API - 新規
/v1/chat/completionsで、max_tokensの別名としてmax_completion_tokensを受け付けます。 Chat Completions - 修正
Responses ストリームの
response.completedイベントに、output配列が含まれるようになりました。 Responses API - 新規
GET /v1/modelsのエントリに、display_name、context_window、max_output_tokens、pricing、capabilities、endpointsが含まれるようになりました。 モデルと料金 - 新規
すべての応答に
x-request-idが付き、送信した値はそのまま返されます。リクエストボディは最大 32 MiB まで可能です。 - 新規
新しいキーを発行せずに、キーを無効化できるようになりました。使用量ログはページ分割されます。
- 変更
max_tokensは 1〜65,536 の範囲に収められます。範囲外の値は拒否されず、最も近い端の値に調整されます。 Chat Completions
- 新規
shannon-coder-1は、/v1/chat/completionsと/v1/messagesでプランごとの呼び出し回数で計上されます。枠の呼び出し回数を使い切ると、応答は429で、メッセージはShannon Coder call quota reachedになります。 CLI コーディングツール - 新規
コンテキストウィンドウより大きい会話には、
400、タイプinvalid_request_error、コードcontext_length_exceededで応答します。ストリーム内のエラーは、回答内のテキストではなくエラーイベントとして届きます。 CLI コーディングツール
- 新規
shannon-1.6-liteに加えて、モデル IDshannon-1.6-pro、shannon-2-lite、shannon-2-pro、shannon-coder-1を追加。 モデルと料金
- 新規
API の最初のリリース:OpenAI 形式と Anthropic 形式のチャット、および Responses エンドポイント。いずれも
sk-で始まる API キーで呼び出します。 認証