LogoWan API ドキュメント
ホーム
X (Twitter)
ホーム

はじめに

概要連携ガイド残高を確認タスクを削除

Wan モデル

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance モデル

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

画像モデル

Seedream 5.0 ProSeedream 5.5 API

言語モデル

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Claude Sonnet 5.5 API

Claude Sonnet 5.5 API:適応型・ツール間の思考、パラメーター制限、ストリーミング、グループ別の入力・出力・キャッシュ料金。

このリファレンスでは Claude Sonnet 5.5 と、このモデル固有の Messages パラメーターを説明します。POST https://api.wanapi.app/v1/messages に claude-sonnet-5-5 を指定してください。Claude モデルを比較。

モデル設定

設定Claude Sonnet 5.5
モデル IDclaude-sonnet-5-5
コンテキストウィンドウ1M トークン
同期応答の最大出力思考を含む 128000 トークン
思考モード適応型、または between_tools
effort の既定値high
強制ツール呼び出し(any / tool)非対応

接続とリクエスト送信

API キー設定でキーを作成してください。1 つの API キーですべてのモデルとグループを利用できます。サーバーの環境変数 WAN_API_KEY に保管してください。anthropic-version: 2023-06-01 を送り、必要な機能を使う場合にのみ anthropic-beta を追加します。

curl https://api.wanapi.app/v1/messages \
  -H "x-api-key: $WAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
  }'
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app",
)
message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))

現在の API 対応範囲

以下の表は、このモデル本来の API 仕様を説明しています。Wan API は現在、互換レイヤーを通してリクエストを転送します。max_tokens には正の値を指定してください。現在のゲートウェイは 0 を生成用のトークン上限に置き換えるため、この接続ではキャッシュの事前作成だけを行う用途には使えません。

現在のゲートウェイは diagnostics、compaction、fallbacks、fallback_credit_token、thread を転送しません。また、現在のチャネル設定では speed、service_tier、inference_geo も除外されます。以下ではモデル本来の仕様を説明するためにこれらのフィールドを掲載していますが、この接続ではまだ利用できません。応答が成功しても、無視されたフィールドが有効になったとは限りません。これらのフィールドを必要とするベータ機能にも、同じ制限が適用されます。

パラメーター

パラメーター型 / 必須公式仕様の制約と既定値
model文字列、必須claude-sonnet-5-5。
max_tokens整数、必須思考トークンを含む 0–128000。公式 API では 0 は出力を生成せずにプロンプトキャッシュを作成します。「現在の API 対応範囲」も確認してください。
messagesオブジェクト配列、必須会話メッセージは最低 1 件、最大 100000 件。各メッセージに role と content を指定します。content は文字列またはコンテンツブロック配列。通常のターンは user/assistant です。会話途中の system メッセージは公式の配置ルールに従います。
system文字列またはテキストブロック配列最上位の指示。テキストブロックにキャッシュの区切り位置を指定できます。
thinkingオブジェクト既定は {"type":"adaptive"}。もう 1 つの対応モードは {"type":"between_tools"}。手動予算と disabled は拒否されます。
thinking.display列挙値適応型モードのみ。omitted(既定)または summarized。要約の省略は、思考の無効化を意味しません。
thinking.block_bindingオブジェクト、ベータ適応型モードのみ。thinking-binding-controls-2026-08-01 が必要です。公式の思考保持の仕様に従ってください。
output_config.effort列挙値または nulllow、medium、high、xhigh、max。既定は high。null では既定値を使います。
output_config.formatオブジェクトまたは null構造化 JSON 出力:{"type":"json_schema","schema":{...}}。対応する JSON Schema のサブセットを使います。
stream真偽値既定は false。true は SSE イベントを返します。
stop_sequences文字列配列公式仕様では、一致する文字列で生成を停止します。上流の互換性検証では、この動作は反映されませんでした。
temperature数値または null互換性のため 1 のみ受け付けます。省略してください。それ以外の null でない値は拒否されます。
top_p数値または null互換性のため 0.99–1 のみ受け付けます。省略してください。
top_knull 以外は不可サンプリング設定には対応していません。このプロパティは省略してください。
toolsオブジェクト配列クライアントツールには name、input_schema、任意の説明や厳密性の設定を指定します。サーバーツールはバージョン付きの公式定義を使います。
tool_choiceオブジェクトauto(既定)または none。any と名前を指定した強制 tool は拒否されます。auto には disable_parallel_tool_use を指定できます。
metadata.user_id文字列または null最大 512 文字。個人情報を直接含まない識別子を使ってください。
cache_controlオブジェクトまたは nulltype: "ephemeral"、ttl: "5m"(既定)または "1h"。Sonnet 5.5 ではキャッシュ可能なトークンが最低 512 必要です。公式 API はブロック単位のキャッシュ区切りにも対応しています。
diagnosticsオブジェクトまたは nullprevious_message_id:最大 256 文字の文字列または null。キャッシュの差異の診断を要求します。
service_tier列挙値auto(既定)または standard_only。
speed列挙値または null省略するか、standard / null を指定します。Sonnet 5.5 は fast に対応していません。
inference_geo文字列または null公式の既定値はアカウント設定で決まります。リクエストが受理されただけでは、処理地域は確認できません。
fallbacks文字列、オブジェクト配列、または null、ベータ"default" または最大 3 件のフォールバック設定。各設定に model が必要で、max_tokens、thinking、output_config、speed を任意で上書きできます。フォールバックのルールも確認してください。
fallback_credit_token文字列、オブジェクト、または null以前の拒否応答に含まれるトークン、または {"token":"...","mode":"strict"}。オブジェクト形式には fallback-credit-2026-07-01 が必要です。mode は strict(既定)または best_effort。null でない fallbacks との併用は不可。
container文字列、オブジェクト、または nullコンテナ ID、または任意の id と skills(最大 20 件)を含むコンテナ設定。スキルには公式の型、識別子、バージョンのフィールドを使います。
context_managementオブジェクトまたは nulledits を含む公式のコンテキスト編集設定。null は設定の省略を意味します。モデルごとの編集互換性の制約も適用されます。
mcp_serversオブジェクト配列公式の MCP サーバー定義。必要なベータバージョンとサーバー認証に従います。空の配列による疎通確認だけでは、リモート MCP の実行は検証できません。
compactionオブジェクトまたは null、ベータcompact-2026-09-04 と {"type":"summarize"} を指定します。null は圧縮の省略を意味します。有効な圧縮は、null でない context_management、停止文字列、構造化出力形式と併用できません。署名付き圧縮の動作は現在の検証を通過していません。
messages[].output_config.effort列挙値、ベータsystem メッセージ単位の effort。mid-conversation-output-config-2026-07-01 が必要です。effort のみの system メッセージはどこにでも置けます。本文を含む system メッセージ群は公式の配置ルールに従います。between_tools モードでは effort を変更できません。

思考とツール

between_tools では type プロパティと、effort の low、medium、high のみを受け付けます。display、budget_tokens、block_binding は同時に送らないでください。例:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

assistant の事前入力には対応していません。pause_turn を継続するには、返されたサーバーツールの assistant コンテンツを変更せずに再送します。圧縮は既存の履歴を要約するもので、assistant の事前入力ではありません。思考ブロックと署名を完全に保持してください。公式の紐づけルールに従わずに、モデル間で移動したり過去の履歴を編集したりしないでください。

ネイティブ Claude API でのコンピューター操作には computer_toolset_20260801 が必要で、computer_20251124 は拒否されます。この実行モデルでは、claude-opus-4-8、claude-opus-4-7、claude-sonnet-5 を指定した Advisor 設定も拒否されます。

メディア入力

画像と PDF は、一般公開された HTTP(S) URL を user メッセージの content ブロックに指定してください。ファイルはご自身でホストする必要があります。この接続には Files API やアップロード機能はありません。画像入力の例:

{"role":"user","content":[
  {"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
  {"type":"text","text":"What does this chart show?"}
]}

PDF には document ブロックを使います。会話を続ける際は、ツール使用 ID、完全な思考ブロック、署名を変更せずに保持してください。クライアントツールはアプリケーションが実行して結果を返します。ツールの宣言だけでは実行されません。

料金

100 万トークンあたりの米ドル料金

現在の単価には各グループの倍率が反映されています。料金情報は最大 2 分間キャッシュされます。

1 つの API キーですべてのモデルとグループを利用できます。「デフォルト」は自動ルーティング順で最初に利用できるグループを示します。実際に選ばれたグループの単価で課金されます。

Claude Sonnet 5.5

claude-sonnet-5-5

Claude Sonnet 5.5 — 100 万トークンあたりの米ドル料金
課金対象トークンclaude · デフォルト
すべての入力長
入力(未キャッシュ)$1
出力$5
キャッシュ読み取り$0.05
キャッシュ書き込み · 5 分$1.25
キャッシュ書き込み · 1 時間$2

— は確認済みの単価がないことを示します。無料という意味ではありません。

キャッシュ単価は、レスポンスに対応するキャッシュ使用量が報告された場合のみ適用されます。キャッシュされたトークンを未キャッシュ入力として二重に数えないでください。

各課金対象トークン数に対応する単価を掛け、合計を 1,000,000 で割ります。思考トークンは出力トークンに含まれ、二重には課金されません。キャッシュ読み取り、5 分間の書き込み、1 時間の書き込みにはそれぞれ別の単価があります。入力長に応じて料金が変わる場合は、適用される料金区分を選んでからリクエスト料金を計算してください。

応答とストリーミング

完了したメッセージには id、type、role、model、content、stop_reason、usage が含まれます。テキストは content のテキストブロックから取得してください。先頭のブロックは思考やツール呼び出しの場合もあります。以下は説明用の例です。

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 24, "output_tokens": 18}
}

SSE を使うには stream: true と curl -N を指定します。message_start、content_block_start、content_block_delta、content_block_stop、message_delta、message_stop に加え、ping とストリーム内のエラーも処理してください。各チャンクを完全なレスポンスとして扱わず、最終的な使用量を確認します。

OpenAI 互換形式

同じモデル ID を POST /v1/chat/completions と POST /v1/responses でも使えます。Authorization: Bearer YOUR_API_KEY を指定し、OpenAI SDK のベース URL を https://api.wanapi.app/v1 に設定してください。Chat Completions は messages、Responses は input を使います。これらのフィールドは Messages 形式へ変換されるため、上記のネイティブパラメーターを使う場合は /v1/messages を利用してください。

curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'

使用ログとエラー

LLM ログでは、過去 7 日間に完了した呼び出しのモデル、入力トークン数、出力トークン数、料金を確認できます。呼び出し後に更新し、claude-sonnet-5-5 で絞り込んでください。画像・動画にはタスクログを使います。

リクエストが失敗したら、HTTP ステータスと error オブジェクトを確認してください。キー、残高、モデル ID、対応するパラメーターの組み合わせを確認します。拒否応答や出力上限による停止は、HTTP エラーとは異なります。リクエストやストリームが中断した場合は、再試行前にログを確認してください。新しいリクエストでは追加料金が発生することがあります。

モデルの参考資料

  • Sonnet 5.5 公式概要
  • Sonnet 5.5 の変更点と制約
  • Messages パラメーターリファレンス
  • メッセージ単位の effort
  • オンデマンド圧縮
  • 拒否応答とフォールバック
  • フォールバッククレジット

Claude Haiku 5.5

Claude Haiku 5.5 API:適応型・無効化可能な思考、強制ツール呼び出し、パラメーター、ストリーミング、グループ別トークン料金。

Claude Opus 5.5

Claude Opus 5.5 API:常時有効な適応型思考、既定の medium effort、パラメーター、ストリーミング、グループ別トークン料金。

目次

モデル設定接続とリクエスト送信現在の API 対応範囲パラメーター思考とツールメディア入力料金応答とストリーミングOpenAI 互換形式使用ログとエラーモデルの参考資料