nano-banana2 图片生成工具

nano-banana2 图片生成工具

API 端点

生产环境

POST https://gpt-i18n.byteintl.net/​gpt/​openapi/​online/​multimodal/​crawl?ak=gGoT3706okXuOVHBBhA1SBG8erOvgihU_GPT_AK

办公网络环境

POST https://genai-sg-og.tiktok-row.org/​gpt/​openapi/​online/​multimodal/​crawl?ak=gGoT3706okXuOVHBBhA1SBG8erOvgihU_GPT_AK

完整请求示例

import requests
import json
import base64
import uuid
from datetime import datetime

def generate_image_nano_banana(prompt, aspect_ratio="1:1", image_size="1K", network="production"):
    """
    使用 nano-banana2 生成图片
    
    Args:
        prompt: 图片描述提示词
        aspect_ratio: 图片比例，支持 21:9, 16:9, 4:3, 3:2, 1:1, 9:16, 3:4, 2:3, 5:4, 4:5
        image_size: 图片大小，支持 "1K" 或 "2K"
        network: 网络环境，"production" 或 "office"
    
    Returns:
        dict: 包含图片base64数据和元信息
    """
    
    # 选择正确的端点
    if network == "office":
        url = "https://genai-sg-og.tiktok-row.org/​gpt/​openapi/​online/​multimodal/​crawl"
    else:
        url = "https://gpt-i18n.byteintl.net/​gpt/​openapi/​online/​multimodal/​crawl"
    
    # 添加 API key
    url += "?ak=gGoT3706okXuOVHBBhA1SBG8erOvgihU_GPT_AK"
    
    # 生成 logid
    logid = f"nanobanana_{uuid.uuid4().hex}_{int(datetime.now().timestamp())}"
    
    headers = {
        "Content-Type": "application/​json",
        "X-TT-LOGID": logid
    }
    
    data = {
        "stream": False,
        "model": "nano-banana2",
        "max_tokens": 20000,
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "type": "text",
                        "text": prompt
                    }
                ]
            }
        ],
        "response_modalities": ["TEXT", "IMAGE"],
        "image_config": {
            "aspectRatio": aspect_ratio,
            "imageSize": image_size,
            "imageOutputOptions": {
                "mimeType": "image/​png"
            }
        }
    }
    
    response = requests.post(url, headers=headers, json=data)
    
    if response.status_code == 200:
        result = response.json()
        if result.get("code") == 0:
            # 提取图片数据
            messages = result.get("data", {}).get("choices", [])[0].get("message", {})
            multimodal_contents = messages.get("multimodal_contents", [])
            
            images = []
            for content in multimodal_contents:
                if content.get("type") == "inline_data":
                    image_data = content.get("inline_data", {})
                    images.append({
                        "base64": image_data.get("data"),
                        "mime_type": image_data.get("mime_type"),
                        "prompt": prompt,
                        "aspect_ratio": aspect_ratio
                    })
            
            return {
                "status": "success",
                "images": images,
                "logid": logid
            }
    
    return {
        "status": "error",
        "error": f"Request failed: {response.status_code}",
        "response": response.text
    }

def save_base64_image(base64_data, filename):
    """保存 base64 图片到文件"""
    image_data = base64.b64decode(base64_data)
    with open(filename, 'wb') as f:
        f.write(image_data)
    print(f"Image saved: {filename}")

# 使用示例
# result = generate_image_nano_banana("一只可爱的柴犬在公园里玩耍", aspect_ratio="16:9", image_size="2K")
# if result["status"] == "success" and result["images"]:
#     save_base64_image(result["images"][0]["base64"], "shiba_inu.png")

Bash 命令示例

# 生成图片的 curl 命令
curl --location 'https://gpt-i18n.byteintl.net/​gpt/​openapi/​online/​multimodal/​crawl?ak=gGoT3706okXuOVHBBhA1SBG8erOvgihU_GPT_AK' \
--header 'Content-Type: application/​json' \
--header 'X-TT-LOGID: nanobanana_test_'$(date +%s) \
--data '{
    "stream": false,
    "model": "nano-banana2",
    "max_tokens": 20000,
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "生成一张南方小城老旧居民区的照片，写实风格"
                }
            ]
        }
    ],
    "response_modalities": ["TEXT","IMAGE"],
    "image_config": {
        "aspectRatio": "16:9",
        "imageSize": "2K",
        "imageOutputOptions": {
            "mimeType": "image/​png"
        }
    }
}' | jq '.data.choices[0].message.multimodal_contents[] | select(.type=="inline_data") | .inline_data.data' -r | base64 -d > output.png

参数说明

必填参数

可选参数

支持的比例

• 横向: 21:9, 16:9, 4:3, 3:2
• 方形: 1:1
• 纵向: 9:16, 3:4, 2:3
• 灵活: 5:4, 4:5

图片尺寸

• 1K: 标准质量（默认）
• 2K: 高质量

响应处理

成功响应结构

{
    "code": 0,
    "msg": "success",
    "data": {
        "choices": [{
            "finish_reason": "stop",
            "message": {
                "multimodal_contents": [
                    {
                        "type": "text",
                        "text": "好的，为你生成..."
                    },
                    {
                        "type": "inline_data",
                        "inline_data": {
                            "mime_type": "image/​png",
                            "data": "base64_encoded_image_data"
                        }
                    }
                ]
            }
        }]
    }
}

提取图片数据

# 从响应中提取所有图片
def extract_images(response_json):
    images = []
    choices = response_json.get("data", {}).get("choices", [])
    
    for choice in choices:
        contents = choice.get("message", {}).get("multimodal_contents", [])
        for content in contents:
            if content.get("type") == "inline_data":
                images.append(content.get("inline_data"))
    
    return images

使用建议

1. 提示词优化

   • 使用详细的描述获得更好的结果
   • 指明风格、光线、氛围等细节
   • 可以使用中文或英文提示词

2. 比例选择

   • 角色肖像：使用 2:3 或 3:4
   • 场景横幅：使用 16:9 或 21:9
   • 社交媒体：使用 1:1 或 9:16

3. 批量生成

   • 可以通过多次调用实现批量生成
   • 建议每批控制在 5-10 张

4. 网络环境

   • 办公网络使用 tiktok-row.org 域名
   • 其他环境使用 byteintl.net 域名

错误处理

def handle_error(response):
    if response.status_code == 400:
        return "请求参数错误，请检查参数格式"
    elif response.status_code == 401:
        return "API Key 无效或过期"
    elif response.status_code == 429:
        return "请求频率过高，请稍后重试"
    else:
        return f"未知错误: {response.status_code}"

注意事项

1. API Key 安全：请勿在生产环境中硬编码 API Key
2. 图片存储：生成的图片为 base64 格式，需要及时保存
3. 请求频率：避免过于频繁的请求，建议间隔 1-2 秒
4. 内容审核：生成内容需符合相关法律法规