認證與基礎 URL
透過將您的nano banana api指向https://api.nanobananaapis.com/v1來存取。您需要在Authorization標頭欄位中提供有效的 API 金鑰。只需使用電子郵件和密碼在取得 API 金鑰頁面註冊，即可立即獲得金鑰。金鑰會在註冊後立即顯示。如果遺失，可從您的儀表板重新產生新金鑰；舊金鑰會立即失效。
每個請求都使用 Bearer YOUR_API_KEY。模型 ID 始終為 uncensored。此端點處理輸入文字與輸出文字。它不產生圖片、音訊或影片。對於多模態管線，請使用此 API 進行提示詞撰寫、腳本產生與後處理。
首次請求
發送標準的聊天完成請求。API 支援 OpenAI 格式。將 YOUR_API_KEY 替換為你的實際金鑰。此範例向無審查模型發送簡單訊息。
curl https://api.nanobananaapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'回應包含產生的文字。你可以在回應主體中檢查 token 用量。上下文視窗總計為 100,000 個 token（包含提示詞與補全）。請將請求主體保持在 8 MB 以下。
Python SDK 範例
使用官方的 OpenAI Python SDK。將基礎 URL 設定為 nanobananaapis 端點。將你的 API 金鑰作為 api_key 傳遞。用戶端會自動正確格式化請求。此方法非常適合需要在將文字傳送給圖片或影片產生服務之前進行處理的後端腳本。
from openai import OpenAI
client = OpenAI(base_url="https://api.nanobananaapis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)SDK 會為你處理串流與解析。如果啟用串流模式，你可以遍歷資料塊。此方法保持程式碼簡潔，並在日後切換供應商時與其他 OpenAI 服務相容。
Node SDK 範例
Node.js SDK 運作方式類似。使用你的基礎 URL 和金鑰初始化用戶端。呼叫 chat.completions.create 方法。這對於需要動態產生腳本的無伺服器函式或網頁伺服器很有用。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nanobananaapis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);確保你正確處理錯誤。常見錯誤包括金鑰無效或過期時的認證失敗（401），以及超過每分鐘 300 次請求時的速率限制（429）。API 金鑰與你的帳戶綁定，因此請將其保護在環境變數中。
串流回應
在請求中設定 stream: true 以啟用串流輸出。API 會傳回伺服器推送事件 (SSE) 串流。每個區塊包含部分產生的文字。這對於即時應用程式或產生長腳本至關重要。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)在你的客戶端側解析 SSE 事件。當模型完成生成或達到上下文限制時，串流結束。串流可降低使用者的感知延遲。它不會改變定價；你仍然按 token 付費。
限制、錯誤與模型
透過 GET /v1/models 檢查可用模型。唯一的模型為 uncensored。速率限制為每支金鑰每分鐘 300 次請求。請求主體必須低於 8 MB。定價為每 1M 輸入 token $0.25，每 1M 輸出 token $1.00。額度永不過期。如果用完，請從 $10 起儲值。錯誤碼：金鑰無效傳回 401，額度不足傳回 402，超過速率限制傳回 429。不提供服務等級協議或可用性保證。該模型會封鎖涉及未成年人的色情內容。它不會拒絕其他合法的成人或具爭議性主題。
