API ドキュメント
MAI Code 2 API ドキュメント
MAI Code 2 API は OpenAI Chat Completions 形式に対応しています。OpenAI クライアントを下の Base URL に向け、キーを Bearer トークンとして使い、mai-code-2 または mai-code-2-flash を選びます。
クイックスタート
- トップページでキーを作成してコピーします。キーは sk_maicode2_ で始まります。
- $5 からの 1 回払いで残高を追加します。
- Base URL とキーを使ってリクエストを送ります。
https://maicode2.com/v1curl https://maicode2.com/v1/chat/completions \
-H "Authorization: Bearer $MAICODE2_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mai-code-2",
"messages": [{"role": "user", "content": "Write a Python function that checks if a string is a palindrome."}]
}'エディターやエージェントで MAI Code 2 を使う
OpenAI 互換プロバイダーを追加できるツールならどれでも使えます。Base URL を設定し、キーを貼り付け、モデル ID を入力します。よくある構成は、チャットとエージェントに MAI Code 2、オートコンプリートや補助モデルに MAI Code 2 Flash を使う方法です。
API Provider: OpenAI Compatible
Base URL: https://maicode2.com/v1
API Key: sk_maicode2_your_key
Model ID: mai-code-2VS Code で拡張機能の設定を開き、OpenAI Compatible プロバイダーを選びます。
リファレンス
POST /v1/chat/completions
応答を生成します。対応フィールド:model、messages、max_tokens または max_completion_tokens、temperature、top_p、stop、stream、stream_options、tools、tool_choice、parallel_tool_calls、response_format、seed、presence_penalty、frequency_penalty、reasoning_effort。その他のフィールドは無視され、n は 1 である必要があります。
stream: true にすると、応答は Server-Sent Events で届き、data: [DONE] で終わります。stream_options.include_usage を設定すると、最後にトークン数を含むチャンクを受け取れます。
{
"model": "mai-code-2",
"messages": [{"role": "user", "content": "What is in src/app.ts?"}],
"tools": [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a file from the repository",
"parameters": {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}
}
}]
}GET /v1/models
現在利用できるモデルを一覧表示します。
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"GET /v1/balance
キーを所有するアカウントの残り USD 残高を返します。
curl https://maicode2.com/v1/balance -H "Authorization: Bearer $MAICODE2_API_KEY"課金
各リクエストは使用したトークン数に応じて USD 残高から課金され、最低 $0.001 です。開始前に、推定入力と max_tokens 分の費用が仮押さえされ、終了後に実際の使用量だけが課金されて残りはすぐに戻ります。残高が max_tokens 分に足りない場合は小さい max_tokens で実行し、256 トークン未満になる場合は 402 で拒否します。失敗したリクエストは課金されません。
すべての応答に X-Request-Id ヘッダーが付きます。ストリーミングでない応答には、最終請求額を示す X-Balance-Charged-Usd も付きます。
料金とチャージを見る →エラーと制限
エラーは OpenAI のエラー形式なので、SDK はいつもどおりの例外を投げます。
{
"error": {
"message": "Insufficient balance: this request needs at least $0.004. Add balance at https://maicode2.com/pricing.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}リクエストと応答の内容は保存しません。保存するのは計測データ(モデル、トークン数、費用、状態、時刻)だけです。