Nano Banana API
Google の Nano Banana を1つの統合 API で使い、画像を生成・編集。単一の REST エンドポイント、非同期ジョブ、Webhook を備え、Google Cloud のセットアップは不要です。
Nano Banana を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。
model: "nano-banana"
Nano Banana の特長
- 1:1, 3:4, 4:3 を含む 5 種類のアスペクト比に対応。
- 画像から画像への編集と参照画像に対応。
- 高速処理 — 1回の生成あたり平均約15秒。
- Google のアカウント不要の従量課金。成功した生成分だけお支払いいただきます。
- Apiframe のすべてのモデルで、1つのAPIキー・統一請求・冪等性・Webhookに対応。
Nano Banana で作成
Apiframeの Nano Banana API で生成した出力例です。
Change the wall color in this living room photo to sage green, keeping everything else the same.
Blend this product photo, this fabric texture, and this background into one seamless ad image.
Show this same character in four panels, waking up, commuting, working, and relaxing, consistent look.
A photorealistic product mockup of a cereal box reading 'OAT CRUNCH' on a kitchen counter.
Place me in this scenic mountain background, matching the lighting and perspective.
Turn this daytime street photo into a rainy night scene with neon reflections.
概要
- エンドポイント
- POST /v2/images/generate
- モデルID
- nano-banana
- パラメータキー
- nanoBananaParams
- モダリティ
- 画像
- プロバイダー
- 平均完了時間
- ~15s
機能
クイックスタート
APIキーを添えて POST /v2/images/generate に1回リクエストを送るだけで Nano Banana による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "nano-banana",
"nanoBananaParams": {
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"google_search": false,
"image_search": false
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "nano-banana",
"nanoBananaParams": {
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"google_search": False,
"image_search": False
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "nano-banana",
"nanoBananaParams": {
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"google_search": false,
"image_search": false
}
}),
});
const { jobId } = await response.json();
console.log(jobId);レスポンスとジョブのライフサイクル
生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする(または webhook_url を指定する)と、result フィールドに出力URLが格納されます。
1. 送信レスポンス (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. 結果をポーリング
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);入力スキーマ
Nano Banana エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。
| パラメータ | 型 | 必須 | デフォルト | 許可値 / 範囲 | 説明 |
|---|---|---|---|---|---|
| prompt | string | 必須 | — | — | 生成する内容のテキスト説明。 |
| model | string | 必須 | "nano-banana" | "nano-banana" | このエンドポイントのモデル識別子。 |
| nanoBananaParams.image_input | string (URL) | 任意 | — | — | Compose with or edit a reference image. |
| nanoBananaParams.output_format | string | 任意 | "jpg" | "jpg", "png", "webp" | Output format |
| nanoBananaParams.google_search | boolean | 任意 | false | — | Google search grounding |
| nanoBananaParams.image_search | boolean | 任意 | false | — | Image search grounding |
よくある質問
Nano Banana APIに関するよくある質問をまとめました。
Nano Banana の API はありますか?
はい。Apiframe は単一の REST エンドポイント(`POST /v2/images/generate`、`model: "nano-banana"`)で Nano Banana を提供します。対応するすべてのモデルで、統一されたAPI・キー・請求をご利用いただけ、Google の個別アカウントは不要です。
Nano Banana API の料金はいくらですか?
Nano Banana は Apiframe のシンプルな従量課金制で、成功した生成分のみお支払いいただきます。プランと数量割引は料金ページをご覧ください。
Nano Banana API はどのように呼び出しますか?
`X-API-Key` と、`model: "nano-banana"` を含む JSON ボディを添えて `/v2/images/generate` に POST リクエストを送ります。レスポンスで返る `jobId` を `GET /v2/jobs/{id}` でポーリングするか、Webhook で結果を受け取ります。
Nano Banana はどんなパラメータに対応していますか?
Nano Banana は、共通の `prompt`・`webhook_url` に加えて、`nanoBananaParams` の下にネストされた 4 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。
解決しませんでしたか?
Nano Banana API で開発を始めよう
APIキーを取得すれば数分で Nano Banana を統合できます — 従量課金。
ご質問はありますか? Discordに参加 または 営業に問い合わせる。