本ドキュメントでは、Alibaba Cloud Model Studio で MindLab 直供の Macaron モデル推論サービスを呼び出す方法について説明します。
本ドキュメントに記載されている機能は、シンガポールリージョンでのみ利用可能です。モデルを使用するには、シンガポールリージョンから呼び出してください。
サービスの有効化
- Model Studio コンソール に移動し、MindLab または Macaron を検索して、MindLab Macaron シリーズのモデルカードを見つけ、「今すぐ有効化」をクリックします。
- ダイアログボックスで、有効化と承認を確認します。
クイックスタート
MindLab は Macaron シリーズのモデルを提供しています。mindlab/macaron-v1-tall、mindlab/macaron-v1.1-venti、mindlab/macaron-v1.1-coding-venti が含まれます。以下のコードを実行して、mindlab/macaron-v1.1-venti モデルをストリーミングモードで素早く呼び出してください。
API キーを取得 し、API キーを環境変数として設定 している必要があります。SDK を使用してモデルを呼び出す場合は、SDK をインストール する必要もあります。
- OpenAI 互換性
- Anthropic 互換性
reasoning_effort パラメータは標準の OpenAI パラメータではありません。OpenAI Python SDK では extra_body で渡します。Node.js SDK ではトップレベルのパラメータとして渡します。- Python
- Node.js
サンプルコード
思考制御
Macaron シリーズのモデルはハイブリッド推論モデルです。reasoning_effort パラメータで推論の深さを制御できます。指定可能な値: low、medium、high、xhigh、max。
思考プロセスは reasoning_content フィールドで返されます。mindlab/macaron-v1-tall の思考プロセスは reasoning フィールドで返されます。
マルチターンの会話では、
preserve_thinking を true に設定すると、履歴の reasoning_content をモデル入力に連結できます。パラメータのサポート状況
次の表に、Macaron シリーズのモデルがサポートする OpenAI 互換パラメータを示します。
| パラメータ | 説明 | サポート状況 |
|---|---|---|
| model(string) | model パラメータで使用するモデルを指定します。 | サポート |
| messages(array) | ユーザーとモデルの会話履歴です。 | サポート |
| stream(boolean) | ストリーミング出力を使用するかどうかを制御します。 | サポート |
| stream_options(object) | ストリーミング出力の設定項目(include_usage)です。 | サポート |
| temperature(float) | モデル応答のランダム性と多様性を制御します。 | サポート |
| top_p(float) | nucleus サンプリングの確率しきい値です。 | サポート |
| top_k(float) | 生成プロセスでサンプリングに使用する候補トークン数を指定します。 | 未サポート |
| repetition_penalty(float) | 生成される連続シーケンスの繰り返し度です。 | 未サポート |
| presence_penalty(float) | 生成されるシーケンス全体の繰り返し度を制御します。 | 未サポート |
| response_format(object) | 返されるコンテンツの形式(text、json_object、json_schema)です。 | サポート |
| max_tokens(integer) | モデルが生成できるトークンの最大数を指定します。 | サポート |
| n(integer) | 生成するレスポンスの数(1~4)です。 | サポート |
| enable_thinking(boolean) | 思考モードを有効にするかどうかを指定します。 | サポート |
| preserve_thinking(boolean) | 履歴の reasoning_content をモデル入力に連結するかどうかを指定します。 | サポート |
| thinking_budget(integer) | 思考プロセスの最大トークン数です。 | サポート |
| reasoning_effort(string) | 推論の深さを制御します(low、medium、high、xhigh、max)。 | サポート |
| tool_stream(boolean) | Function Calling の tool_call arguments をストリーミングで返すかどうかを指定します。 | 未サポート |
| enable_code_interpreter(boolean) | コードインタープリター機能を有効にするかどうかを指定します。 | サポート |
| seed(integer) | 生成に使用する乱数シードです。 | 未サポート |
| logprobs(boolean) | 出力トークンの対数確率を返すかどうかを指定します。 | サポート |
| top_logprobs(integer) | 返す最も確率の高い候補トークンの数(0~5)です。 | サポート |
| stop(string or array) | コンテンツ生成プロセスを正確に制御します。 | サポート |
| tools(array) | モデルが呼び出せるツールを指定します。 | サポート |
| tool_choice(string or object) | ツール選択戦略(auto、none、specific)です。 | サポート |
| parallel_tool_calls(boolean) | 並列ツール呼び出しを有効にするかどうかを指定します。 | 未サポート |
| enable_search(boolean) | インターネット検索結果を参考に使用するかどうかを指定します。 | 未サポート |
| search_options(object) | インターネット検索の戦略設定です。 | 未サポート |
| skill(object) | 特定の生成スキル(PPT 生成など)を有効にします。 | 未サポート |
| instructions(string) | OpenAI Responses API 互換フィールドです。 | サポート |
モデル一覧と課金
Macaron シリーズのモデルは MindLab から提供され、シンガポールリージョン(International デプロイ範囲)でのみ利用可能です。
| モデル ID | コンテキストウィンドウ | モデル情報 |
|---|---|---|
mindlab/macaron-v1-tall | 256K | mindlab/macaron-v1-tall |
mindlab/macaron-v1.1-venti | 1M | mindlab/macaron-v1.1-venti |
mindlab/macaron-v1.1-coding-venti | 1M | mindlab/macaron-v1.1-coding-venti |
思考モードでは、思考連鎖は出力トークンとして課金されます。