まずこちらをお読みください:このAPIの用途と非用途
「nano banana api」を使って画像を生成する方法をお探しでこちらに辿り着いた場合、正直なところこのサービスではその機能は提供されていません。「Nano Banana」は画像生成モデルに一般的に付けられる名称ですが、画像生成はここでは提供されていません。nanobananaapis.comが販売しているのは、OpenAI互換のエンドポイントを通じてテキスト言語モデルにアクセスする権限です。
これは多くの画像ワークフローに適合します。画像ツールは入力するテキストの質に依存するからです。テキストモデルはプロンプトの作成、バリエーションの生成、スタイルガイドとの照合、キャプションや代替テキストの作成、パイプラインを繋ぐスクリプトのドラフト作成が可能です。このページはその用途について解説しています。画像のみが必要な場合は画像サービスをご利用ください。こちらと組み合わせることもできます。
このモデルは独立したプロバイダが運用する単一のオープンウェイトモデルで、法的な成人向け利用においてコンテンツ拒否なしで回答するようにチューニングされています。大手ベンダーの公式APIではありません。唯一の制限:未成年者を含む性的コンテンツはありません。
ステップ1:キーの取得
Google、またはメールアドレスとパスワードでサインアップし、API キーページを開いてください。無料トライアルクレジット$0.50を受け取るためのワンクリックボタンが表示されます。これは7日間有効で、カードの登録は不要です。1人1回限りの制限があります。トライアルキーでは同時2件のリクエストと1分あたり60件のリクエストが可能で、試すには十分です。
キーをコピーしてリポジトリから外に保管してください。シェルでは以下のように保存できます:
export NANOBANANA_KEY="paste-your-key-here"
ステップ2:初回リクエストを送信する
重要なのは3つの値です:ベースURL、モデルID、Authorizationヘッダー。その他はすべてOpenAIのchat-completions形式に従います。以下はcurlを使った最初の呼び出しです:
curl https://api.nanobananaapis.com/v1/chat/completions -H "Authorization: Bearer $NANOBANANA_KEY" -H "Content-Type: application/json" -d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
],
"max_tokens": 200
}'
公式openaiパッケージを使ったPythonでの実装:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)
Nodeでは:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nanobananaapis.com/v1",
apiKey: process.env.NANOBANANA_KEY,
});
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);
レスポンスヘッダーを一度確認してください。X-Balance-USDは残高クレジットの残額を表示し、X-Request-Idはヘルプが必要な場合にそのリクエストを識別します。ドキュメントページには、サポートされているすべてのパラメータがリストされています。
ステップ3:アイデアを構造化されたプロンプトに変換する
画像パイプラインで最も有用なトリックは、自由なテキストの代わりに構造化データをモデルに返させることです。JSONモードがそれを実現します。システムメッセージでスキーマを記述し、返信はコードに直接解析されるため、大まかなアイデアのリストが固定フィールドを持つプロンプトのテーブルになります。
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
SYSTEM = (
"You write prompts for an image model. Reply with JSON only: "
'{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)
def expand(idea: str, n: int = 3):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
temperature=0.9,
messages=[
{"role": "system", "content": SYSTEM},
{"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
],
)
return json.loads(r.choices[0].message.content)["prompts"]
for p in expand("a lighthouse keeper's kitchen in winter"):
print(p["full"])
多様性が必要な場合はtemperatureを上げ、一貫性が必要な場合は下げます。seedパラメータはそのまま渡されるため、以前のバッチを再現する必要がある場合は固定できます。言語モデルは誤りを起こす可能性があるため、常にjson.loadsをtryブロックで囲み、解析に失敗した場合は1回再試行してください。
サイトには画像側の関連解説も用意されています:プロンプト生成と後処理。テキストステップがジェネレーターにどのように接続されるかがカバーされています。
画像ワークフローでテキストモデルが得意とするその他のタスク
- スタイルシート。固定されたスタイルルールを含むシステムメッセージを1つ保持し、各新しい被写体をそれに通してください。そうすれば、一連の画像が視覚的に一貫性を保ちます。
- キャプションと代替テキスト。画像が存在したら、それぞれ数語で説明します。画像の説明を入力として渡してください。APIはテキストのみを受け取るため、モデルは画像を見ることができません。
- ショットリストとスクリプト。ストーリーボードや短編動画の場合、シーンリスト、ボイスオーバー、画面内のリズムをテキストとして下書きしてください。
- プロンプトの批評。悪い結果を生むプロンプトを貼り付け、変更点を説明する3つの書き直しを依頼します。
- 成人向けのフィクションとキャラクター制作。物語やコンパニオンアプリ用のキャラクターシート、バックストーリー、ダイアログを作成します。このモデルは法的に許可された成人向けテーマを拒否しません。
長時間のタスクでは、stream: trueで出力をストリーミングし、ユーザーインターフェースが到着したテキストを表示できるようにします。ツール呼び出しもサポートされており、モデルが独自の関数(例えば画像サービスへのプロンプト送信など)をいつ呼び出すかを判断できます。
制限と実行コスト
バッチ構築の前に数値を確認してください。完全なキーでは同時リクエストが8件、1分あたりのリクエストが300件まで可能です。コンテキストウィンドウは100,000トークンで、プロンプトとcompletionをカバーします。最大のリクエストボディサイズは8 MBです。max_tokensはオプションです。レート制限を超えるとHTTP 429が返され、コードはrate_limitedまたはconcurrencyになります。待機して再試行してください。
価格は1M入力トークンあたり$0.15、1M出力トークンあたり$0.50です。400トークンの入力と600トークンの出力を持つ500セットのプロンプトを生成すると仮定します:
- 入力:500 x 400 = 200,000トークン x $0.15 / 1M = $0.03
- 出力:500 x 600 = 300,000トークン x $0.50 / 1M = $0.15
- 合計:$0.18
つまり、$0.50のトライアルクレジットでは、そのサイズのセットが約1,300セット分カバーされます。通常の使用では、暗号資産(TRC20上のUSDT、Base上のUSDC)で$20から$500までの任意の整数金額をチャージしてください。ボーナスは$50から5%、$100から10%、$200から15%です。表については価格ページをご覧ください。クレジットは期限切れになりません。
画像サービスとの連携
通常のセットアップは2つのステージに分かれます。テキストステージはこのAPIを使ってプロンプトを生成します。画像ステージはそれらのプロンプトをお使いの画像ジェネレーターに送信します。そのジェネレーターには独自のアカウント、独自の価格、独自のルールがあり、それらはジェネレーターのサイトで確認してください。どちらか一方を書き換えずにどちらかを変更できるように、2つのステージを別々の関数に保持してください。
実用的なヒント:生成に使用したseedとtemperatureとともに、すべてのプロンプトを保存してください。画像がうまくいった場合、それを生成した正確なテキストに遡ることができます。バッチが期待外れだった場合、問題がアイデア、プロンプト作成者、または画像モデルのどちらにあるかを確認できます。また、同じアイデアのリストで両方のシステムメッセージを実行し、2セットのプロンプトを並べて評価することで、2つのシステムメッセージを比較する安価な方法にもなります。
簡易エンドツーエンドスクリプト
これらを組み合わせるために、次の短いスクリプトはラフなアイデアのファイルを読み込み、JSONモードを使用して各アイデアをプロンプトに展開し、画像ツールが読み取れるファイルに結果を書き出します。このスクリプトは、有効なJSONではない応答という、さもないとあなたを襲う失敗モードの1つを処理します。
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
def one(idea: str):
for _ in range(2):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
{"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
],
max_tokens=250,
)
try:
return json.loads(r.choices[0].message.content)["prompt"]
except (json.JSONDecodeError, KeyError):
continue
return None
ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)
まず5つのアイデアで実行し、結果を目で確認してください。プロンプトが希望するスタイルに一致するまでシステムメッセージを調整し、その後スケーリングします。ここでは各リクエストが小さいため、1000個のアイデアは高速に完了し、コストは数セントです。
初心者が犯す間違い
- 画像を期待していること。 応答は常にテキストです。コードが応答からバイナリ画像を保存しようとすると、画像が存在しないため失敗します。
- 別のモデル名をお探しですか。 モデルは1つだけで、そのIDは
uncensoredです。チュートリアルからベンダーのモデル名をコピーすると、not-foundエラーが発生します。 - システムメッセージを忘れている場合。それがないと、モデルにはスタイルのガイダンスがなく、短いプロンプトと長いプロンプトの間で逸脱します。ルールをそこに置いてください。
- プロンプトにシークレットを送信している。プロンプトはトレーニングには使用されませんが、パスワードや秘密鍵を任意のモデル入力に貼り付けるのは避けてください。
- 一度に100件のリクエストを実行している場合。完全なキーでは同時に8件までです。プールまたはセマフォを使用し、429に対するリトライを追加してください。
何かが奇妙な動作をする場合、サポートページで質問してください。レスポンスヘッダーからのリクエストIDがあれば、質問を答えるのがはるかに容易になります。
