Antigravity API完全ガイド：SDK・料金・プロキシ設定まで

Antigravity APIとは？ どんなことができるの？

4つの操作面：SDK、CLI、IDE、デスクトップ

室谷代表取締役

Antigravity API、実は4つの異なる表面を持ってるんですよ。SDK、CLI、IDE、そしてデスクトップアプリ。

用途によって選べる設計になってます。

テキトー教師.AI認定講師

そうなんです。初めて触る人は「どれを使えばいいんだろう」ってよく聞かれます。

でもそれぞれ役割がはっきりしてますよね。

室谷代表取締役

そう。CLIはターミナルで高速にエージェントを立ち上げたい人向け。

SDKはPythonでプログラム的に制御したい研究開発チーム。IDEはコードエディタに統合された体験。

デスクトップは複数エージェントの統合管理。

テキトー教師.AI認定講師

たしかに、現場のニーズに合わせて選べるのはいいですね。最初は「とりあえずCLIで試してみる」って人が多いです。

マネージドエージェントとしてのAntigravity Agent

室谷代表取締役

もう一つ大きなポイントが、Gemini API経由でマネージドエージェントとして呼び出せること。Antigravity Agentがサーバーレスで動くんです。

テキトー教師.AI認定講師

これは学習コストが低いですよね。API一本でコード実行、ファイル操作、Web検索まで任せられる。

室谷代表取締役

エンタープライズだと、「自分でインフラ用意するのは嫌だ」という声が多いんですよ。マネージドならその辺の面倒がない。

テキトー教師.AI認定講師

はい。環境が分離されているので、セキュリティ的にも安心して使えると好評です。

実際の操作感とユースケース

室谷代表取締役

実際に使ってみると、コード生成からテスト実行、ドキュメント作成まで一つのAPIで完結するのが便利ですね。

テキトー教師.AI認定講師

そうなんです。今まで複数のツールを行き来していた作業が、Antigravity Agentに指示を出すだけで完了する。

室谷代表取締役

MYUUUの現場でも、コードレビューの下書きやレポート作成に使ってます。時給換算するとかなりのコスト削減になる。

テキトー教師.AI認定講師

最初に戸惑うのは「どこまで任せていいのか」という線引きですね。そこさえ慣れれば、開発速度が確実に上がります。

APIキーの設定と認証方法

Gemini APIキーの取得と設定

室谷代表取締役

まず大前提として、AntigravityのManaged AgentをGemini API経由で使うなら、Gemini APIキーが必要なんですよね。Google AI Studioの画面から発行できます。

テキトー教師.AI認定講師

たしかに、そこが最初の入り口ですね。APIキーはGoogleアカウントがあれば誰でも取得できて、無料枠も用意されてます。

室谷代表取締役

キーを取得したら、環境変数 GEMINI_API_KEY に設定するか、コード内で直接指定します。MYUUUの現場では .env ファイルで管理するのがスタンダードです。

テキトー教師.AI認定講師

あと、APIキーをGitにうっかりコミットしないよう注意ですね。初めての人は .gitignore に .env を追加するのを忘れがちです。

SDKでの認証（OAuthとAPIキー）

テキトー教師.AI認定講師

次にAntigravity SDKですが、あれはローカルで動くPythonライブラリですよね。認証はどうなってるんですか？

室谷代表取締役

SDK自体はAPIキー不要です。pip install google-antigravity して Agent を動かすとき、裏で動くバイナリがローカルで完結するので。

ただ、将来的にリモートのAgent Runtimeに繋ぐ場合は別途認証が必要になるでしょうね。

テキトー教師.AI認定講師

なるほど。つまりManaged Agentを呼ぶときだけGemini APIキーが必要で、SDK単体ならそのまま使えると。

室谷代表取締役

そうです。OAuthは主にAntigravityのデスクトップアプリやCLIで使われますが、SDKではまだ標準では対応していないと思います。

よくある設定ミスと対策

テキトー教師.AI認定講師

現場でよく聞くのは、APIキーの環境変数名を間違えるケースです。GOOGLE_API_KEY じゃなくて GEMINI_API_KEY が正しいんですよね。

室谷代表取締役

あと、キー自体は正しく設定しても、APIの利用上限に達してエラーになるパターン。無料枠だとすぐ頭打ちになるので、プロダクションで使うならGoogle AI Ultraのサブスクリプションを検討したほうがいいです。

テキトー教師.AI認定講師

もう一つ、APIキーをコードにハードコードしてしまう問題。環境変数にするだけでもセキュリティは上がりますね。

室谷代表取締役

そう。キーが漏れると意図しないコストが発生する可能性もあるので、管理はきっちりやりたいところです。

Antigravity SDKで始めるPython API

pip install google-antigravity と最小コード

室谷代表取締役

SDK、pip install google-antigravity するだけ。型も効くし、非同期のコンテキストマネージャでエージェントのライフサイクルを管理する設計になってる。

テキトー教師.AI認定講師

最小コードは本当に短くて、こんな感じです。

import asyncio
from google.antigravity import Agent, LocalAgentConfig

async def main():
    config = LocalAgentConfig()
    async with Agent(config) as agent:
        response = await agent.chat("ファイル一覧を教えて")
        print(await response.text())

asyncio.run(main())

室谷代表取締役

エディタやCLIと同じランタイムが動くから、ローカルでのプロトタイプに最適。プロダクションに持っていくときも、デプロイ先を後から変えられる設計らしい。

エージェントのカスタマイズとツール拡張

テキトー教師.AI認定講師

ただ、エージェントの振る舞いをもっと細かくコントロールしたいですよね。カスタムツールの登録とか。

室谷代表取締役

Python の関数をそのままツールとして渡せる。MCP サーバーもツールチェーンに加えられる。

あとはシステム命令でペルソナを定義すれば、専門エージェントに仕立てられる。

テキトー教師.AI認定講師

たとえば「ソースコードのレビュー専門」とか「テスト自動化専門」に特化させられる。実際にチームで使うと便利です。

SDKのリポジトリとコミュニティ

室谷代表取締役

GitHub リポジトリで公開中で、Issue も活発。すでに Proxy ツールで他のモデルと組み合わせるプロジェクトも出てる。

テキトー教師.AI認定講師

コミュニティハンドブックなんかも有志が書いてて、実践的なノウハウが共有され始めてますね。

室谷代表取締役

プレビュー段階だけどアーリーに試す価値はある。SDK の改良がそのまま自分のエージェントに反映されるのもメリット。

Gemini API経由でAntigravity Agentを呼び出す

Interactions APIの基本

室谷代表取締役

Gemini APIのInteractions APIを使うと、一回の呼び出しでAntigravity Agentが起動するんですよ。これ、MYUUUの現場でも「とりあえず動かす」のスピードが段違いでした。

テキトー教師.AI認定講師

たしかに、コード実行からWeb検索まで一つのエンドポイントで済むのは大きいですね。最初に戸惑うのは「環境」パラメータの指定で、Linuxサンドボックスが自動で立ち上がる感覚がつかめないことでしょうか。

室谷代表取締役

そこさえ押さえれば、あとはエージェントが自分で動く。時給換算すると、手動でDockerを組むより数倍効率的です。

ROIで見て導入しない手はない。

テキトー教師.AI認定講師

その通りで、ここのシンプルさが開発者にとっての最初の壁を越えるポイントですね。

マネージドエージェントの特性

テキトー教師.AI認定講師

このマネージドエージェント、中身はAntigravityのエージェントハーネスそのものだそうですね。Gemini 3.5 Flashが動いていると聞きました。

室谷代表取締役

そうです。コード実行、ファイル管理、Google検索、URL取得がデフォルトで使える。

つまり、普通のAPIラッパーじゃなくて、本格的な自律エージェントが手に入るわけです。

テキトー教師.AI認定講師

ファイルが持続する点も重要で、複数ターンにまたがって同じ状態を引き継げる。これ、ハマる人多いんですよ。

室谷代表取締役

そして自動コンテクスト圧縮もかかる。135kトークン辺りでトリガーされるとか。

長期タスクを任せられるのは経営目線でも安心材料です。

Google AI Studioとの連携

室谷代表取締役

Google AI Studioからも同じマネージドエージェントを触れるんです。プロトタイプ段階ではあっちで試す方が早い。

テキトー教師.AI認定講師

初心者にはAI StudioのGUIの方がわかりやすいですね。ただし、本番運用を考えるとInteractions API経由の方が制御しやすい。

室谷代表取締役

その辺は使い分けですね。AI Studioで検証して、APIに移行するフローがベストプラクティス。

テキトー教師.AI認定講師

確かに。最初のハードルを下げる意味でも、まずはAI Studioで動作確認してからAPIに切り替えるのが現場感覚ではスムーズです。

サードパーティプロキシでClaudeや他モデルと連携する

Antigravity Claude Proxyの仕組みと使い方

室谷代表取締役

コミュニティ製のプロキシで、AntigravityのCloud CodeをAnthropic互換のAPIとして公開できるやつが出てきてます。具体的にはローカルでプロキシを立てて、Claude Code CLIからGeminiモデルを叩けるようにする仕組みですね。

テキトー教師.AI認定講師

そうなんです。初めて触る人は「npx antigravity-claude-proxy@latest start」で起動できるのを知らないみたいで、結構ハマるポイントになってます。

室谷代表取締役

俺もMYUUUのチームで試させたんだけど、Node.jsさえ入ってれば数分で動く。コスト的にはAntigravityの無料枠を食う形だから、個人で使うなら悪くない選択肢ですよね。

テキトー教師.AI認定講師

ただ、事前にAntigravityをインストールしてGoogleアカウントを追加しておく必要があるので、その準備を忘れないようにですね。

Anti-APIで多プロバイダをまとめる

テキトー教師.AI認定講師

もう一つ有名なのがAnti-APIです。こっちはAntigravityのモデルをOpenAIとAnthropicの両方の形式に変換できるプロキシで、CodexやGitHub Copilot、Zedなんかもまとめて扱えるのが特徴です。

室谷代表取締役

つまり一つのプロキシで複数のバックエンドを切り替えられる。チームで使うなら管理画面もあるし、アカウントの自動ローテーション機能が入ってる。

ROIで見ると、何個もプロキシ立てるよりこっちの方が効率いい。

テキトー教師.AI認定講師

設定がちょっと複雑で、YAMLやDocker composeを使うのが標準です。ただ、READMEに沿ってやれば動くので、手順を追えば大丈夫ですよ。

室谷代表取締役

とはいえ、これらはあくまで非公式のリバースエンジニアリングベース。安定性は公式のものと比べると落ちるし、更新に追随できないリスクもある。

利用時の注意点（ToS違反リスク）

テキトー教師.AI認定講師

そして何より重要なのが、利用規約違反のリスクです。Antigravity Claude ProxyのREADMEにも「Googleがアカウント停止の措置をとっている」と警告が出てます。

室谷代表取締役

USのコミュニティでもban報告が散見される。法人アカウントで使うのは事実上無理だと思います。

コスト節約のために使ったら本業に影響が出る、みたいな本末転倒になりかねない。

テキトー教師.AI認定講師

個人で検証目的に使うなら自己責任で、というラインですね。本番運用は避けた方が無難です。

室谷代表取締役

結局、公式のGemini APIやAntigravity APIを正規ルートで使うのが結果的に安くて安全。プロキシはあくまで実験的な選択肢として捉えるのが賢いと思います。

料金プランとコスト比較

AI Ultra $100/月の詳細

室谷代表取締役

Google I/O 2026で発表されたAI Ultra、月額100ドルで5倍の使用上限がついてくる。構造的にGoogle AI Proとの差別化が明確で、ヘビーユーザー向けに設計されてる感じですよね。

テキトー教師.AI認定講師

たしかに。Proだと足りなくなったときにアップグレードする、って流れが自然に作られてます。

最初はProで様子見して、Antigravityをがっつり使い始めたらUltraに移行するパターンが王道ですね。

室谷代表取締役

あと、新規・既存問わずUltra登録者に100ドルのボーナスクレジットがつくキャンペーンもやってる。期限は5月25日までですが、実質1ヶ月無料で試せる計算になる。

テキトー教師.AI認定講師

そこが大きいですね。まずはUltraに申し込んで、その100ドルを使い切る前に自分に合うか判断する、と。

無料枠とクレジット

室谷代表取締役

ベースのAntigravityアプリ自体は無料でダウンロードできます。そこに標準の使用枠がついてくる。

あくまで個人開発者が日常的に使う分には無料枠で十分という設計かな。

テキトー教師.AI認定講師

最初に戸惑うのが無料枠の上限なんですが、ドキュメントでは具体的な数値が明示されてない。環境によって変動するものなので、使ってみて足りなければProやUltraを検討する、という流れになります。

室谷代表取締役

その点、Ultraの100ドルボーナスは実質的な無料試用期間として機能する。ガッツリ使いたい人はいきなりUltraに飛びつくのも手です。

テキトー教師.AI認定講師

あと、キャンペーンは期間限定なので、タイミングを逃さないようにしたいところですね。

プロキシ利用時のコスト

室谷代表取締役

サードパーティのプロキシ経由で他モデルと連携するケース、セットアップの手間がかかるだけでなく、間接コストも見落としがちです。

テキトー教師.AI認定講師

たしかに。プロキシサーバーを自前で立てるならサーバー代、Dockerで動かすならそのリソース消費。

無料のプロキシもあるけど、安定性やレート制限が不透明だったりする。

室谷代表取締役

それに、利用規約違反でアカウント停止リスクを伴うものもある。コスト面だけでなく、リスク含めて考えると、公式のAI Ultra契約のほうが長期的には安心感があります。

テキトー教師.AI認定講師

結局、趣味の範囲で試すなら無料枠＋プロキシ、本格的に開発に組み込むなら公式有料プラン、という棲み分けが現実的ですね。

API連携のベストプラクティスとトラブルシューティング

サブエージェントを活用した並列タスク

室谷代表取締役

Antigravity 2.0のサブエージェント機能、コスト効率で考えるとかなり重要なんですよね。直列処理だと待ち時間がそのままコストになるので、並列で回せる部分は回した方がROIが上がる。

テキトー教師.AI認定講師

たしかに。初めて使う人は「エージェントは1体だけ」と思いがちですが、実際は複数のサブエージェントにタスクを振れる。

コードレビューとテスト生成を同時に走らせる、みたいな使い方が現場では効果的です。

室谷代表取締役

Antigravity CLIでも並列サブエージェント管理ができるので、ターミナル派も同じ体験が可能。SDKならプログラムでサブエージェントをspawnできるので、さらに柔軟です。

テキトー教師.AI認定講師

ポイントはタスクの粒度ですね。細かく切りすぎると切り替えのオーバーヘッドが増えるので、ある程度の塊で依頼するのがコツ。

現場感覚だと1つのサブエージェントに10分以上かかる処理を任せると安定します。

よくあるエラーと対処法

テキトー教師.AI認定講師

現場でよく聞くのは認証周りのトラブルです。APIキーの設定ミスや、プロキシ経由の環境で接続が通らないケースが多い。

最初に公式ドキュメントの認証手順を確認するのが一番の近道ですね。

室谷代表取締役

エラーが起きるとその分の実行時間が無駄になるので、事前のバリデーションが大事。特に料金プランの上限に近づいているときは、AI Ultraのボーナスクレジットを活用する判断も必要です。

テキトー教師.AI認定講師

あとはレート制限。大量のリクエストを短時間に送ると引っかかることがあります。

SDKにはlifecycle hooksがあるので、ツールコールの前後にチェックを入れてリトライ処理を実装しておくと安心です。

室谷代表取締役

エラーハンドリングの設計はコスト削減にも直結するので、最初の段階で組み込んでおくことをおすすめします。

セキュリティとコンプライアンス

室谷代表取締役

AntigravityはSecurity by Designで、デフォルトで安全なローカル実行とツール承認のゲートが備わってます。エンタープライズ案件でも安心して使える設計ですね。

テキトー教師.AI認定講師

現場で迷うのは「エージェントにどの権限を与えるか」というところ。SDKにはinspect/decide/transformのフックがあるので、ツールコールの内容を検証しながら権限を絞れます。

室谷代表取締役

機密データを扱う場合はManaged Agentsのセキュアなサンドボックスが有効です。あとはプロキシ系のサードパーティツールを使うとき、GoogleのToS違反でアカウント停止リスクがあるという報告もあるので注意が必要です。

テキトー教師.AI認定講師

公式の連携方法を優先して、非公式のプロキシはリスクを理解した上で使うのが良いですね。最新の情報は公式ドキュメントで確認する習慣をつけましょう。

よくある質問

Q1. Antigravity APIには無料トライアルや無料枠はありますか？

テキトー教師.AI認定講師

よく聞かれる質問なんですよ。多くのAPIサービスが無料枠を用意しているので、気になるところですね。

室谷代表取締役

一般的には、リクエスト数や時間制限付きのフリーティアが用意されているケースが多いです。ただプランによっては従量課金のみの場合もあるので、公式ドキュメントで確認するのが確実ですね。

テキトー教師.AI認定講師

そうですね。まずは無料枠の有無をチェックしてから、本格導入を検討するのが無難かと。

Q2. サードパーティプロキシ経由で他モデルと連携する際、セキュリティ面で注意すべきことはありますか？

室谷代表取締役

プロキシを使う場合、認証情報の管理が重要です。APIキーが漏れると第三者に悪用される可能性があるので、環境変数やシークレット管理サービスを使いましょう。

テキトー教師.AI認定講師

あと、プロキシサーバー自体が信頼できるものかどうかも大事ですね。社内で管理するか、実績あるサービスを選ぶのが安心です。

Q3. Antigravity APIはPython以外の言語からも使えますか？

テキトー教師.AI認定講師

公式SDKはPythonが多いですが、REST APIとして提供されていれば事実上どんな言語からでもHTTPリクエストで呼び出せます。

室谷代表取締役

エンジニアリングの現場では、curlで動作確認してから各言語のラッパーを自作するケースもありますね。SDKの有無はスタート時の手間に関わりますが、本質的にはAPI仕様が安定していれば問題ないです。

Q4. APIキーに有効期限はありますか？また、漏洩した場合の対処法は？

室谷代表取締役

多くのAPIではキーに有効期限が設定されていて、定期的なローテーションが推奨されます。漏洩したらすぐにキーを無効化して再発行するのが基本です。

テキトー教師.AI認定講師

実際、現場で「キーを間違ってGitHubにプッシュした」という話をよく聞くので、git-secretsなどのツールで予防するのがおすすめです。

Q5. Antigravity APIと直接Antigravity Agentを使うのとでは、どう使い分ければいいですか？

テキトー教師.AI認定講師

API経由だとプログラムからエージェントの呼び出しを細かく制御できます。直接使うほうが簡単ですが、自動化やバッチ処理にはAPIが向いていますね。

室谷代表取締役

料金面でも、APIのほうがリクエスト単位で課金されることが多いので、利用頻度によってはコスト最適化しやすいです。用途に応じて切り替えるのが現実的です。

まとめ

室谷代表取締役

Antigravity APIは、エージェントをプログラムから自在に操れる点で、自動化やプロダクト組み込みに大きく貢献します。シリコンバレーでもAPIファーストの設計はスタンダードになりつつありますね。

テキトー教師.AI認定講師

たしかに、最初は「APIって難しそう」と感じる人も多いですが、SDKやドキュメントが整備されていれば意外とスムーズに入っていけます。まずは簡単なスクリプトから触ってみるのがいいでしょう。

室谷代表取締役

料金プランも複数あるので、自分のユースケースに合ったものを選んでください。小規模から始めて、必要に応じてアップグレードするのが賢い使い方です。

テキトー教師.AI認定講師

プロキシ連携で他のモデルも使えるので、Antigravity APIをハブとして多様なAIサービスを組み合わせるのも面白いですね。ぜひ試してみてください。