
Nano Banana Text-to-Image API by Google
Google's state-of-the-art image generation and editing model.
程式碼範例
import requests
import time
# Step 1: Start image generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "google/nano-banana/text-to-image",
"prompt": "A beautiful landscape with mountains and lake",
"width": 512,
"height": 512,
"steps": 20,
"guidance_scale": 7.5,
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] == "completed":
print("Generated image:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
image_url = check_status()安裝
為您的程式語言安裝所需的套件。
pip install requests驗證
所有 API 請求都需要透過 API 金鑰進行驗證。您可以從 Atlas Cloud 儀表板取得 API 金鑰。
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP 標頭
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}切勿在客戶端程式碼或公開儲存庫中暴露您的 API 金鑰。請改用環境變數或後端代理。
提交請求
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())提交請求
提交非同步生成請求。API 會傳回一個預測 ID,您可以用它來檢查狀態並取得結果。
/api/v1/model/generateImage請求主體
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "google/nano-banana/text-to-image",
"input": {
"prompt": "A beautiful landscape with mountains and lake"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")回應
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}檢查狀態
輪詢預測端點以檢查請求的當前狀態。
/api/v1/model/prediction/{prediction_id}輪詢範例
import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)狀態值
processing請求仍在處理中。completed生成完成。輸出已可取得。succeeded生成成功。輸出已可取得。failed生成失敗。請檢查錯誤欄位。完成回應
{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}上傳檔案
上傳檔案至 Atlas Cloud 儲存空間並取得 URL,可用於您的 API 請求。使用 multipart/form-data 上傳。
/api/v1/model/uploadMedia上傳範例
import requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")回應
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}輸入 Schema
以下參數可在請求主體中使用。
無可用參數。
範例請求主體
{
"model": "google/nano-banana/text-to-image"
}輸出 Schema
API 傳回包含生成輸出 URL 的預測回應。
範例回應
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills
Atlas Cloud Skills 將 300 多個 AI 模型直接整合至您的 AI 程式碼助手。一鍵安裝,即可使用自然語言生成圖片、影片,以及與 LLM 對話。
支援的客戶端
安裝
npx skills add AtlasCloudAI/atlas-cloud-skills設定 API 金鑰
從 Atlas Cloud 儀表板取得 API 金鑰,並設為環境變數。
export ATLASCLOUD_API_KEY="your-api-key-here"功能
安裝完成後,您可以在 AI 助手中使用自然語言存取所有 Atlas Cloud 模型。
MCP Server
Atlas Cloud MCP Server 透過 Model Context Protocol 將您的 IDE 與 300 多個 AI 模型連接。支援任何 MCP 相容的客戶端。
支援的客戶端
安裝
npx -y atlascloud-mcp設定
將以下設定新增至您 IDE 的 MCP 設定檔中。
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}可用工具
API Schema
Schema 不可用Nano Banana - Google 革命性視覺 AI
新功能又稱 Gemini 2.5 Flash Image
Google 最新的多模態 AI 技術突破,提供前所未有的圖像生成和編輯功能,具有閃電般的速度和卓越的品質。
- 多圖融合技術
- 跨生成的角色一致性
- 風格保留轉換
- 高達 4K 的高分辨率輸出
- 基於文本的智能編輯
- 對象添加和移除
- 背景替換
- 風格轉移和藝術效果
Prompt Examples & Templates
Explore curated prompt templates to unlock the full potential of Nano Banana AI. Click to copy any prompt and start creating immediately.

Photo to Character Figure
Transform any photo into a realistic character figure with packaging and displayturn this photo into a character figure. Behind it, place a box with the character's image printed on it, and a computer showing the Blender modeling process on its screen. In front of the box, add a round plastic base with the character figure standing on it. set the scene indoors if possible

Anime to Cosplay
Transform anime illustrations into realistic cosplay photographyGenerate a highly detailed photo of a girl cosplaying this illustration, at Comiket. Exactly replicate the same pose, body posture, hand gestures, facial expression, and camera framing as in the original illustration. Keep the same angle, perspective, and composition, without any deviation

Person to Action Figure
Transform people from photos into collectible action figures with custom packagingTransform the the person in the photo into an action figure, styled after [CHARACTER_NAME] from [SOURCE / CONTEXT]. Next to the figure, display the accessories including [ITEM_1], [ITEM_2], and [ITEM_3]. On the top of the toy box, write "[BOX_LABEL_TOP]", and underneath it, "[BOX_LABEL_BOTTOM]". Place the box in a [BACKGROUND_SETTING] environment. Visualize this in a highly realistic way with attention to fine details.

Person to Funko Pop Figure
Transform photos into Funko Pop style collectible figures with custom packagingTransform the person in the photo into the style of a Funko Pop figure packaging box, presented in an isometric perspective. Label the packaging with the title 'ZHOGUE'. Inside the box, showcase the figure based on the person in the photo, accompanied by their essential items (such as cosmetics, bags, or others). Next to the box, also display the actual figure itself outside of the packaging, rendered in a realistic and lifelike style.

Product Design to Photorealistic Render
Transform product design sketches into photorealistic rendersturn this illustration of a perfume into a realistic version, Frosted glass bottle with a marble cap

Transform to Q-Version Character
Create cartoon characters with face shape reference controlTransform the person from image 1 into a Q-version character design based on the face shape from image 2

Building to 3D Architecture Model
Convert architectural photos into detailed physical modelsconvert this photo into a architecture model. Behind the model, there should be a cardboard box with an image of the architecture from the photo on it. There should also be a computer, with the content on the computer screen showing the Blender modeling process of the figurine. In front of the cardboard box, place a cardstock and put the architecture model from the photo I provided on it. I hope the PVC material can be clearly presented. It would be even better if the background is indoors.
技術亮點
優化速度,大多數任務的生成時間不到 2 秒,非常適合實時應用和快速原型開發工作流。
利用 Google 先進的 AI 架構生成高度詳細、逼真的圖像,具有精確的照明、紋理和構圖。
革命性的 2D 到 3D 轉換功能,可從單個圖像創建多個視點,為內容創作開闢新可能性。
使用案例
為什麼選擇 Nano Banana?
無需設置
無需複雜配置或安裝即可立即開始創建精密控制
通過直觀的文本命令微調創作的每個方面一致的結果
在多代生成中保持角色和風格的一致性技術規格
體驗 Nano Banana AI 的力量
加入數千名已經使用 Google 最先進的圖像 AI 技術改變視覺內容的創意人和企業。
Google Nano Banana Text-to-Image
Nano Banana Text-to-Image is Google’s lightweight yet powerful AI image generation model, built for creators who need fast, high-quality visuals from simple text prompts. It transforms words into expressive, realistic images with remarkable clarity, composition, and style diversity — all within seconds.
Try the New Version of Nano Banana!
- Nano Banana Pro
- Nano Banana Pro edit
- Nano Banana Pro Ultra
- Nano Banana Pro Edit Ultra
- Nano Banana Pro Multi
🌟 Why it stands out
-
Instant Image Creation Generate beautiful, coherent visuals from just a short text prompt — no design skills required.
-
Versatile Visual Styles Supports realistic, illustrative, anime, and painterly outputs, adapting naturally to your creative intent.
-
Accurate Text-to-Scene Understanding Accurately interprets subjects, backgrounds, and object relationships to create contextually correct compositions.
-
Fast & Efficient Optimized for quick turnaround and minimal compute cost, perfect for rapid prototyping and social content.
-
Clean, Balanced Lighting Produces visually appealing results without overexposure or unnatural shadows — ideal for portraits, landscapes, and product imagery.
⚙️ Capabilities
-
Input: text prompt
-
Output: high-quality image (JPEG/PNG/WEBP)
-
Supports multiple aspect ratios and output format
-
Compatible with descriptive prompts such as:
- “A golden retriever playing in a field of sunflowers at sunset.”
- “A futuristic city skyline with neon reflections on wet streets.”
- “An elegant still-life photo of coffee and croissants by a window.”
💰 Pricing
- $0.0304 per image
- Commercial use allowed
💡 Best Use Cases
- Social Media & Marketing — Create on-brand visuals instantly.
- Concept Art & Storyboarding — Generate design ideas and moodboards effortlessly.
- E-commerce & Advertising — Produce high-quality product images without photography.
- Education & Presentation — Visualize complex ideas or creative concepts easily.
📝 Notes
Please ensure your prompts comply with Google’s Safety Guidelines. If an error occurs, review your prompt for restricted content, adjust it, and try again.






