コンテンツへスキップ
変更履歴

変更履歴

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 まで可能です。

  • 新規

    新しいキーを発行せずに、キーを無効化できるようになりました。使用量ログはページ分割されます。

  • 新規

    リクエストで画像とドキュメントに対応:/v1/chat/completions では image_url パート、/v1/messages では image、document、file ブロック、/v1/responses では input_image パート。 画像とファイル

  • 新規

    新しいモデル shannon-3-pro。 モデルと料金

  • 新規

    新しいモデル shannon-3。 モデルと料金

  • 新規

    /v1/chat/completions のストリームは、推論を delta.reasoning_content として送信します。 推論 effort

  • 変更

    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 コーディングツール

  • 新規

    /v1 エンドポイント:POST /v1/chat/completions、POST /v1/messages、POST /v1/responses、GET /v1/models。OpenAI と Anthropic の SDK、Claude Code、Codex CLI が呼び出すエンドポイントです。 概要

  • 新規

    /v1/chat/completions と /v1/messages で tools によるツール呼び出し、response_format による構造化出力に対応。/v1/messages では system を文字列またはテキストブロックで指定可能に。 関数呼び出し

  • 新規

    shannon-1.6-lite に加えて、モデル ID shannon-1.6-pro、shannon-2-lite、shannon-2-pro、shannon-coder-1 を追加。 モデルと料金

  • 新規

    API の最初のリリース:OpenAI 形式と Anthropic 形式のチャット、および Responses エンドポイント。いずれも sk- で始まる API キーで呼び出します。 認証