3つの設定を変更するだけで、既存の Anthropic アプリケーションを Model Studio に移行できます。このトピックでは、リクエストとレスポンスのパラメーターについて、コード例を交えて説明します。
既存の Anthropic アプリケーションを Model Studio に移行するには、以下の設定を変更します。
Claude Desktop または Claude Code を設定した後、接続テストが
api_key:Model Studio API キーに置き換えます。base_url:以下に示す Model Studio のエンドポイントに置き換えます。model:qwen3.7-plusなどのサポートされているモデル名に置き換えます。
- シンガポール
- 中国 (北京)
- ドイツ (フランクフルト)
- 米国 (バージニア)
- 日本 (東京)
SDK
base_url:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropicHTTP リクエスト URL:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages{WorkspaceId} を実際のワークスペース ID に置き換えてください。
認証:x-api-key ヘッダーまたは Authorization: Bearer ヘッダーのいずれかでModel Studio API キーを渡します。
リクエストボディmodelstring (必須)モデル名。サポートされているモデル:
サポートされているモデル Qwen-Max: qwen3.8-max, qwen3.7-max, qwen3.7-max-2026-05-20, qwen3.7-max-2026-06-08Qwen-Plus: qwen3.7-plus, qwen3.7-plus-2026-05-26, qwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.5-plus, qwen3.5-plus-2026-04-20, qwen3.5-plus-2026-02-15, qwen-plus, qwen-plus-latestQwen-Flash: qwen3.8-flash, qwen3.7-flash, qwen3.7-flash-2026-07-15, qwen3.6-flash, qwen3.6-flash-2026-04-16, qwen3.5-flash, qwen3.5-flash-2026-02-23, qwen-flash, qwen-flash-2025-07-28Qwen-Coder: qwen3-coder-flashQwen-VL: qwen3-vl-plusQwen オープンソースモデル: qwen3.6-27b, qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3bサードパーティモデルdeepseek-v4-pro, deepseek-v4-flash-0731, kimi-k3.1-pro, kimi-k3, kimi-k2.7-code, kimi-k2.6, kimi-k2.5, glm-5.2, glm-5.1, glm-5, MiniMax-M2.5, deepseek-v4.1-flash-1017 integer (必須)
string or array (任意)モデルの動作を定義するシステムプロンプト。system はトップレベルパラメーターであり、messages 配列は system ロールを受け入れません。文字列は、単一の type="text" ブロックに相当します。プロンプトキャッシュのブレークポイントをマークするには、配列を渡します。
プロパティ type string (必須)固定値:text。text string (必須)システムプロンプトのテキスト。cache_control object (任意)プロンプトキャッシュのブレークポイント。キャッシュヒット時、後続のリクエストはキャッシュ読み取りレートで請求されます。type のみを含み、ephemeral に固定されます。array (必須)user と assistant のターンが交互に並んだメッセージ配列。
messages 配列要素 role string (必須)メッセージのロール。有効な値:user、assistant。content string or array (必須)プレーンテキスト文字列または構造化されたコンテンツ配列。文字列は、type="text" の単一の content ブロックに相当します。
content 配列要素の型 Text
プロパティ type string (必須)固定値:text。text string (必須)テキストコンテンツ。cache_control object (任意)プロンプトキャッシュのブレークポイント。type のみを含み、ephemeral に固定されます。
プロパティ type string (必須)固定値:image。source object (必須)イメージデータのソース。
プロパティ type string (必須)有効な値:url (パブリックイメージ URL)、base64 (Base64 エンコード)。url stringイメージのパブリック URL。type が url の場合に必須です。media_type stringイメージの MIME タイプ (例:image/jpeg)。type が base64 の場合に必須です。data stringBase64 エンコードされたイメージデータ。type が base64 の場合に必須です。
プロパティ type string (必須)固定値:video。source object (必須)ビデオデータのソース。
プロパティ type string (必須)有効な値:url (パブリックビデオ URL)、base64 (Base64 エンコード)。url stringビデオのパブリック URL。type が url の場合に必須です。media_type stringビデオの MIME タイプ (例:video/mp4)。type が base64 の場合に必須です。data stringBase64 エンコードされたビデオデータ。type が base64 の場合に必須です。
プロパティ type string (必須)固定値:tool_use。id string (必須)ツール呼び出しの一意の識別子。後続の tool_result で結果を関連付けるために使用されます。name string (必須)呼び出されたツールの名前。input object (必須)ツール呼び出しの入力パラメーター。構造は、tools 内の対応するツールの input_schema によって決定されます。cache_control object (任意)プロンプトキャッシュのブレークポイント。type のみを含み、ephemeral に固定されます。ツール呼び出しのコンテンツはキャッシュプレフィックスに含まれます。
プロパティ type string (必須)固定値:tool_result。tool_use_id string (必須)tool_use ブロックの id に対応します。content string (必須)ツールによって返されたコンテンツ。cache_control object (任意)プロンプトキャッシュのブレークポイント。type のみを含み、ephemeral に固定されています。boolean (任意)ストリーミングを有効にするかどうか。デフォルト値:false。temperature number (任意)生成されるテキストの多様性をコントロールします。有効値:[0, 2)。値が大きいほど、よりランダムな結果が生成されます。この有効値は、公式の Anthropic の有効値 [0.0, 1.0] とは異なります。Anthropic から移行する際は、このパラメーターの値を確認してください。 number (任意)Nucleus サンプリングの確率しきい値。top_k integer (任意)サンプリング中の候補セットのサイズ。stop_sequences array (任意)生成を停止させるトリガーとなるテキストシーケンス。出力は一致したシーケンスの前に終了します。一致後、応答の stop_reason は end_turn のままであり、応答には一致したシーケンスは含まれません。object (任意)kimi-k3.1-pro はデフォルトで思考が有効です。拡張思考の構成。有効にすると、モデルは応答する前に推論を行い、応答には thinking タイプのコンテンツブロックが含まれます。すべてのモデルが思考モードをサポートしているわけではありません。このパラメーターが渡されない場合、思考が実行されるかどうかはモデルのデフォルトの動作で決まります:qwen3.8-max、qwen3.8-flash、deepseek-v4 シリーズ、glm シリーズ、kimi-k3.1-pro はデフォルトで思考が有効、kimi-k2.6 と kimi-k2.5 はデフォルトで思考が無効、kimi-k2.7-code と MiniMax-M2.5 は思考モードのみサポート (無効化できません)。各モデルの思考モードのサポート状況とデフォルト設定については、ディープシンキングをご参照ください。
プロパティ type string (必須)有効な値:enabled (思考モードを有効にする)、disabled (思考モードを無効にする)。budget_tokens integer (任意)思考プロセスの最大トークン数。max_tokens との関係はモデルによって異なります。詳しくは max_tokens パラメーターの説明をご参照ください。予算が大きいほど、複雑な質問に対してより徹底的な分析が可能になります。type が enabled の場合に有効です。array (任意)関数呼び出しのためのツール定義。
tools 配列要素 name string (必須)ツール名。description string (任意)ツール関数の説明。input_schema object (必須)ツール入力パラメーターの JSON スキーマ定義。kimi-k3.1-pro (Alibaba Cloud Model Studio にデプロイ) は、北京、シンガポール、米国 (バージニア)、ドイツ (フランクフルト)、日本 (東京)、中国 (香港) で、web_search と web_fetch をサポートします。deepseek-v4.1-flash-1017 は、ウェブ検索ツール web_search とウェブ取得ツール web_fetch をサポートします。Anthropic 互換リクエストの要件と例については、ウェブ抽出をご参照ください。tool_choice object (任意)ツール選択戦略:
object (任意)
プロパティ effort string (任意)モデルの推論の強度をコントロールします。有効な値とデフォルト値はモデルによって異なります。デフォルト値:max。kimi-k3.1-pro (Alibaba Cloud Model Studio にデプロイ) のデフォルトは max です。max (深い推論)、high (強化された推論)、medium (中程度の推論)、low (軽い推論) をサポートします。
object (任意)構造化出力の構成。有効にすると、モデルは JSON 文字列を返します。動作はモデルによって異なります。
プロパティ type string (必須)固定値:json_schema。schema object (必須)標準の JSON スキーマ仕様に従う JSON スキーマオブジェクト。type (データの型)、properties (フィールド定義)、required (必須フィールド名の配列)、および additionalProperties ( false に設定する必要があります) を含める必要があります。 |
Python |
非ストリーミング応答idstring一意のメッセージ識別子。type string固定値:message。role string固定値:assistant。model string生成に使用されたモデル。content arrayコンテンツ配列。
content 配列要素の型 Text
プロパティ type string固定値:text。text stringモデルによって生成されたテキスト応答。
プロパティ type string固定値:thinking。thinking string最終応答前のモデルの推論。signature string現在は空の文字列に固定されています。
プロパティ type string固定値:tool_use。id string一意のツール呼び出し識別子。tool_result と一致させるために使用されます。name string呼び出されたツールの名前。input objectツール呼び出しの入力パラメーター。string生成が停止した理由。有効な値:end_turn (正常終了)、max_tokens (トークン制限に到達)、tool_use (ツール呼び出し)。stop_sequence string常に null です。usage objectトークン使用量の統計。ストリーミング呼び出しでは、 message_start イベントの usage フィールドには input_tokens と output_tokens のみが含まれます。4つのフィールドすべては message_delta イベントで返されます。
プロパティ input_tokens integer入力トークン。output_tokens integer出力トークン。cache_creation_input_tokens integerキャッシュ作成で消費されたトークン。cache_read_input_tokens integerキャッシュ読み取りで消費されたトークン。 | 応答例 |
ストリーミング応答message_start最初のストリームイベントで、メッセージの開始を示します。
プロパティ type string固定値:message_start。message object初期メッセージオブジェクト。content は空の配列で、usage には input_tokens と output_tokens のみが含まれます。
プロパティ type string固定値:content_block_start。index integercontent 配列内の位置に対応する0から始まるインデックス。content_block objectコンテンツブロックの初期オブジェクト。type の値は text、thinking、または tool_use です。tool_use タイプの場合、このイベントでは input フィールドは空のオブジェクトであり、完全な入力パラメーターは後続の content_block_delta デルタから組み立てられます。
プロパティ type string固定値:content_block_delta。index integer関連するコンテンツブロックのインデックス。delta objectデルタオブジェクト。type の値:
プロパティ type string固定値:content_block_stop。index integer終了したコンテンツブロックのインデックス。
プロパティ type string固定値:message_delta。delta objectstop_reason と stop_sequence を含みます。有効な値については、上記の非ストリーミング応答の表をご参照ください。usage objectinput_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens を含む、完全なトークン使用量の統計。
プロパティ type string固定値:message_stop。さらに、ストリーミング応答は定期的に ping イベント ({"type":"ping"}) を送信して接続を維持します。クライアントはこれらを無視できます。 | ストリーミング応答の例 |
よくある質問
Claude Desktop または Claude Code を設定した後、接続テストがModel discovery — Gateway /v1/models returned HTTP 404で失敗するか、リクエスト URL に/v1/v1/modelsが含まれます。どうすれば修正できますか?
Claude Desktop や Claude Code などのクライアントのモデル検出機能は、設定されたベース URL に自動的に /v1/models を追加します。次の2点を確認してください。
- ベース URL の末尾を
/v1/にしないでください:末尾は/apps/anthropicである必要があります (たとえば、中国 (北京) の場合はhttps://dashscope.aliyuncs.com/apps/anthropicを使用します。他のリージョンについては、上記のエンドポイント情報をご参照ください)。誤って.../apps/anthropic/v1/と入力すると、クライアントは/v1/modelsを追加し、重複したパス/v1/v1/modelsが生成され、HTTP 404 が返されます。したがって、404 エラーが発生した場合は、まず実際のリクエスト URL に重複した/v1/v1/が含まれていないか確認してください。含まれている場合は、ベース URL から末尾の/v1/を削除してください。 - モデルを手動で追加して検出をスキップする:Model Studio の Anthropic 互換エンドポイントは Messages API (
/v1/messages) のみを提供し、モデルリストエンドポイント (/v1/models) は提供しないため、モデル検出リクエストも 404 を返します。クライアントの [Models] でモデル (例:qwen3.7-plus) を手動で追加して、自動検出をスキップしてください。