MCode

API ドキュメント

MAI Code 2 API ドキュメント

MAI Code 2 API は OpenAI Chat Completions 形式に対応しています。OpenAI クライアントを下の Base URL に向け、キーを Bearer トークンとして使い、mai-code-2 または mai-code-2-flash を選びます。

クイックスタート

  1. トップページでキーを作成してコピーします。キーは sk_maicode2_ で始まります。
  2. $5 からの 1 回払いで残高を追加します。
  3. Base URL とキーを使ってリクエストを送ります。
Base URL
https://maicode2.com/v1
cURL
curl 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 を使う方法です。

Cline / Roo Code / Kilo Code
API Provider:  OpenAI Compatible
Base URL:      https://maicode2.com/v1
API Key:       sk_maicode2_your_key
Model ID:      mai-code-2

VS 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
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"

GET /v1/balance

キーを所有するアカウントの残り USD 残高を返します。

cURL
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 はいつもどおりの例外を投げます。

400無効なリクエスト:不明なモデル、messages の形式誤り、または入力上限超過。
401API キーがない、形式が不正、不明、または取り消し済み。
402このリクエストには残高が足りません。チャージしてから再試行してください。
429レート制限または同時実行数の上限に達しました。Retry-After ヘッダーの時間だけ待ってください。
502モデル提供元がエラーを返しました。仮押さえ分は戻ります。
503モデルは一時的に利用できません。課金はされません。
エラー本文
{
  "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"
  }
}
1 リクエストあたりの入力262,144 トークン
max_tokens の既定値8,192 トークン
max_tokens の上限32,768 トークン
キーごとの毎分リクエスト数120
アカウントごとの同時リクエスト数8

リクエストと応答の内容は保存しません。保存するのは計測データ(モデル、トークン数、費用、状態、時刻)だけです。