すべての連携に必要な3つの値
nanobanana API統合に関するガイドのほとんどは、異なる場所に同じ3つのフィールドを入力するという行為に尽きます。このサービスはOpenAIのチャット補完プロトコルをサポートしているため、OpenAIのエンドポイントをオーバーライドできるツールであれば接続可能です。
| フィールド | 内容 |
|---|---|
| ベース URL | https://api.nanobananaapis.com/v1 |
| API キー | あなたのキーは、Authorization: Bearer <key>として送信されます |
| モデル ID | uncensored |
開始前に1点注意。これはテキスト生成モデルなので、画像生成、音声、埋め込みが期待される場所では動作しません。サポートされているメソッドはPOST /v1/chat/completionsとGET /v1/modelsです。検索に埋め込みモデルを要求するツールがある場合は、その部分を別のプロバイダに指定してください。
キーはAPIキーページから取得できます。新規アカウントは、カード登録なしでワンクリックでトライアルクレジット$0.50を獲得でき、これは7日間有効です。
ツールに触れる前にエンドポイントをテスト
連携が失敗した場合、ユーザーはツールを責める傾向があります。多くの場合、キーまたはURLが間違っています。30秒のcurlテストでその疑いを消せます。まずモデル一覧を取得します:
curl https://api.nanobananaapis.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
次に短いチャットリクエストを送信します:
curl https://api.nanobananaapis.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}],"max_tokens":10}'
両方が動作すれば、エンドポイントとキーは正常であり、その後のエラーはツールの設定に起因します。最初の呼び出しで401が返された場合、キーが間違っているか、ヘッダーにBearerの文字列が含まれていません。404は通常、URLに/v1が含まれていないか、余分なパスがあることを意味します。
SillyTavern
SillyTavernはロールプレイやキャラクターチャットのフロントエンドで、OpenAI互換エンドポイントを追加できます。メニューラベルはバージョンによって異なるため、手順を地図として扱い、正確な表記にこだわらないでください。
- API接続パネルを開き、APIタイプとしてChat Completionを選択します。
- ソースとしてCustom (OpenAI-compatible)を選択します。
- エンドポイントURLとして
https://api.nanobananaapis.com/v1を貼り付けます。 - キーフィールドにAPIキーを貼り付けます。
- モデル名として
uncensoredを入力するか、接続ボタンを押してGET /v1/modelsが返すリストから選択します。 - 接続を押してテストメッセージを送信します。
2つの注意点。SillyTavernはキャラカード付きの長い履歴を送信するため、プロンプトと返信で共有される100,000トークンのコンテキストウィンドウに注意してください。また、グループチャットで複数の同時リクエストが発生する場合は、フルキーの8リクエスト(トライアルキーは2)のレート制限を覚えておいてください。ロールプレイや相棒設定は大人向けです。モデルはどのプロンプトでも未成年者を含む性的コンテンツは生成しません。
LangChain
Pythonでは、langchain-openaiパッケージがカスタムベースURLを受け付けるChatOpenAIを提供します。pip install langchain-openaiでインストールしてください。
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
model="uncensored",
temperature=0.7,
)
print(llm.invoke("Give me three names for a fictional smuggler ship.").content)
チェーン、プロンプトテンプレート、出力パーサーはチャットインターフェースのみを対象とするため、その後同じように動作します。ツール呼び出しは標準的なパスを経由するため、llm.bind_tools([...])はリクエストにtoolsを送信します。エージェントを構築する前に単一のツール呼び出しをテストし、エージェントの並列処理数を8に制限してください。20のブランチに広がるグラフはconcurrencyエラーを引き起こします。
JavaScriptパッケージ@langchain/openaiは、ChatOpenAIのconfiguration: { baseURL }オプションを通じて同じアイデアを実現します。
Cursorおよびその他のエディター
Cursorは他のいくつかのコーディングエディタと同様に、モデル用の設定エリアを持っており、独自のOpenAI APIキーを指定してベースURLを上書きできます。大まかな手順は次の通りです:モデル設定を開き、カスタムOpenAIキーオプションを有効にし、ベースURLの上書き先をhttps://api.nanobananaapis.com/v1に設定し、APIキーを貼り付け、カスタムモデル名としてuncensoredを追加します。
これが何をもたらすか現実的に考えてください。エディタはインライン補完などの機能を独自バックエンドや特定のモデル名で構築しているため、カスタムエンドポイントはチャットまたはコマンドのサブセットにのみ適用される場合があります。正確なオプションはバージョンによって異なるため、エディタの現在のドキュメントを確認してください。埋め込みや画像入力などこのAPIが提供しないものを必要とする機能は、このエンドポイントでは動作しません。
Open WebUI、Continue、および同様のチャットフロントエンドなどの他のOpenAI互換クライアントにも同じパターンが適用されます:カスタムOpenAIエンドポイントのフィールドを見つけ、3つの値を入力してテストします。
標準SDKと環境変数
独自のコードを書く場合、公式SDKは標準環境変数を読み取るため、ソースファイルに触れずにエンドポイントを切り替えることができます。PythonとNode SDKでは、OPENAI_BASE_URLとOPENAI_API_KEYを設定するだけで十分です。
export OPENAI_BASE_URL="https://api.nanobananaapis.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python app.py # app.py calls client.chat.completions.create(model="uncensored", ...)
Nodeでの明示的なクライアントは次のようになります:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nanobananaapis.com/v1",
apiKey: process.env.NANOBANANA_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a short product description for a paper lantern." }],
stream: true,
});
for await (const part of stream) {
process.stdout.write(part.choices[0]?.delta?.content ?? "");
}
ストリーミングはSSE経由で到着し、使用量は最後に報告されます。パラメータの詳細はドキュメントページに記載されており、プロンプト生成に関する記事ではテキストステップを画像パイプラインに接続する方法が示されています。
よくある失敗の修正
| 症状 | 考えられる原因 | 修正方法 |
|---|---|---|
| 401 Unauthorized | キーの間違い、またはヘッダーにBearerが不足 | キーを再入力しcurlでテスト |
| 404 Not Found | ベースURLに/v1が含まれていない、またはパスが二重になっている | 正確にhttps://api.nanobananaapis.com/v1を使用 |
| モデルが見つからない | ツールはベンダーモデル名をデフォルトとして使用します | モデルを uncensored に設定する |
rate_limited付きの429エラー | 1分あたり300リクエスト以上(トライアルは60) | 処理を遅らせて再試行する |
concurrency付きの429エラー | 一度に8件以上のリクエスト(トライアルでは2) | 並列性を低下 |
| Retry-After: 5付きの429 | 一時的な過負荷 | 5秒待ってから再試行してください |
| リクエストが大きすぎます | 本文が8 MBを超える | 添付ファイルまたは履歴を削減 |
ストリーミングリクエストはストリームが終了するまで同時実行スロットを保持するため、ストリームを放棄するエディタは実際にはビジーでなくても制限に達しているように見える場合があります。失敗した呼び出しからのX-Request-Idヘッダーをログに記録してください。サポートはまずそれを求めます。
コスト面では、2,000トークンの入力と500トークンの出力を含む一般的なチャットメッセージは、1Mトークンあたり入力用$0.15、出力用$0.50で$0.00055かかり、失敗したリクエストは課金されません。料金ページでは、$20〜$500のチャージとボーナスティアについて解説しています。
キー、安全性、誰が何を見るか
各統合はキーをどこかに保存しますが、その方法には優劣があります。デスクトップフロントエンドでは、キーはローカル設定ファイルに保存されます。ブラウザベースのツールでは、ブラウザに保存される場合があります。エディタでは、アプリ設定に保存されます。画面を共有する前、dotfileをコミットする前、またはラップトップを誰かに渡す前に、どのタイプを使用しているかを確認してください。
管理しやすくするためのいくつかのルールがあります。可能な限りツールごとに1つのキーを使用し、1つを置き換えるだけで他が壊れないようにしてください。ヘルプを求めるときに公開の問題追跡ツールにキーを貼り付けないでください。代わりにリクエストIDを共有してください。キーが漏洩した場合は、キーページからキーを置き換え、ツールを更新してください。APIを介して送信されたプロンプトはトレーニングに使用されず、残りのデータ処理についてはプライバシーページで説明しています。
他の人のためにフロントエンドをホストする場合は、キーをブラウザに送信しないでください。ユーザーとAPIの間に小さなサーバーを置き、そこで独自の制限を追加し、キーをサーバーに保持してください。ユーザーはあなたの8つの同時リクエストを共有することになるため、同時にチャットできる人数を計画してください。
どのツールがどの仕事に適合するか
統合はどこでも同じであるため、ツールの選択はあなたが何を作っているかに依存します。
- SillyTavernまたは同様のチャットフロントエンドは、コードを書かずに洗練されたインターフェースとキャラクターカードを備えた、大人向けのキャラクターチャット、フィクション、ロールプレイに適しています。
- LangChainは、ローダー、プロンプトテンプレート、パーサー、マルチステップチェーンなど、コード内でのパイプラインに適しています。依存関係が1つ増える代わりに、構造化が追加されます。
- シンプルなSDK呼び出しはスクリプトやサービスに適しています。1つのプロンプトに対して1つの回答を返すタスクの場合、OpenAIパッケージはフレームワークよりも保守が容易です。
- Cursorのようなエディタは、コードに関するチャットに適しています。それを利用する前に、その機能の中でカスタムエンドポイントを受け付けるものがどれあるか確認してください。
まずはシンプルなcurlテストから始め、次にSDKを使い、必要だと感じたときにのみフレームワークを追加してください。3つの値は変更されないため、後で移動するのは簡単です。最初のリクエストとパラメータ一覧については、ドキュメントをお読みください。
