MaxAPI の Gemini Interactions API：テキスト・画像・会話状態
MaxAPI キーで /v1beta/interactions を使用します。curl、ネイティブのストリーム、会話の継続、現在の機能制限を説明します。
技術確認日:
テキストを 1 回リクエスト
POST https://api.maxapi.dev/v1beta/interactions に、MaxAPI キーを x-goog-api-key または Authorization: Bearer で送ります。/v1/interactions も利用できます。generateContent の contents/candidates 形式ではなく model と input を使い、応答の steps と usage を読みます。後で取得する必要のない単発処理には store:false を使います。
curl https://api.maxapi.dev/v1beta/interactions \
-H "x-goog-api-key: $MAXAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"google/gemini-3.1-flash-lite","input":"Say hello.","store":false}'ネイティブイベントをストリーム
JSON に stream:true、curl に -N を追加します。SSE のイベント型と ID を保持するため、OpenAI チャット形式のチャンクとして解析しないでください。終端イベントは課金確定後に届きます。指定された Api-Revision は転送されます。
会話を保存して続ける
store を省略するか true にして保存します。返された int_… ID を次の POST の previous_interaction_id に渡します。GET /v1beta/interactions/{id} で取得し、完了・課金確定後に同じパスへ DELETE できます。所有者だけがアクセスできます。検証済みルートの保存期間は 7 日で上流の容量制限があり、継続には元のチャネルと認証情報が必要です。
画像生成と参照入力
下記の Nano Banana 2.1 画像生成を検証済みです。編集時は input をテキストと画像の配列にします。例：[{"type":"text","text":"Edit the reference"},{"type":"image","mime_type":"image/png","data":"BASE64"}]。有効な画像データとモデルの参照上限を使います。検証済みルートの画像は OpenAI の data[] ではなく、ネイティブのインラインデータです。
curl https://api.maxapi.dev/v1beta/interactions \
-H "x-goog-api-key: $MAXAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model":"google/gemini-nano-banana-2.1",
"input":"Create a blue circle on a white square.",
"store":false,
"response_format":{"type":"image","image_size":"1K","aspect_ratio":"1:1"},
"generation_config":{"max_output_tokens":8192}
}'対応機能の範囲を確認
2026-10-12 の本番検証では Gemini 3 Flash Preview、3.1 Flash Lite、3.1 Pro Preview、3.5 Flash のテキストと Nano Banana 2.1 の画像生成を確認しました。既存のモデル・ルート権限が適用されます。generateContent 対応だけでは Interactions 対応になりません。
現在の検証済みルートはバックグラウンド実行、キャンセル、イベント再開、マネージドエージェントに非対応です。通常の JSON 出力は利用できますが、厳密な response_format.schema と画像 URI 配信は検証で上流エラーになりました。指定を黙って削除せずエラーを返します。async.maxapi.dev の画像タスク既定動作は Interactions のバックグラウンド実行を有効にしません。
課金と中断時の復旧
作成時にクレジットを予約し、ネイティブ使用量と既存単価で 1 回精算します。取得や削除は新しい生成や課金を行いません。X-MaxAPI-Interaction-ID があれば保存し、切断後に受付済みの保存状態を取得します。受付前の明確な 429/503 のみチャネル切替対象で、結果不明のタイムアウトは自動再送しません。再作成前に状態や利用記録を確認します。
モデル別パラメーター
公開設定のスナップショットであり、現在の稼働状況ではありません。パラメーター、ルート、参照画像の上限は各モデルページを確認してください。
- Gemini 3.1 Flash-Lite
google/gemini-3.1-flash-lite - Nano Banana 2.1
google/gemini-nano-banana-2.1