gemini-2.5-flash-image API 图片编辑接口文档

模型名称

nano-banana

gemini-2.5-flash-image

API接口文档

基础信息

• Base URL: https://www.dmxapi.cn/v1/images/edits
• 请求方式: POST
• 认证方式: Bearer Token

请求参数

参数名	类型	必填	说明
prompt	string	是	图像描述文本
size	string	是	图片大小，参考下文
seed	int	否	随机种子(-1表示随机)

site 参数使用比例

1x1 (正方形)、 3x4 (垂直)、 4x3 (水平)、 9x16 (垂直/竖屏)、 16x9 (水平/宽屏)

图片编辑代码示例 (Python)

import base64  # 导入 base64 模块
import json  # 导入 json 模块

import requests  # 导入 requests 库

# API 端点，用于图像编辑和操作
url = "https://www.dmxapi.cn/v1/images/edits"  # <-- 根据你注册的DMXAPI网站修改域名 .com 或 .cn
api_key = "sk-******************************"  # 替换为你的 DMXAPI 令牌

headers = {
    "Authorization": f"Bearer {api_key}"  # 使用你的 API 密钥进行认证
}

# 请求参数，包含编辑的提示词
payload = {
    "model": "gemini-2.5-flash-image",
    "prompt": "给哪吒带上一个红色的鸭舌帽，风格保持不变",  # 描述对上传图片的编辑要求
    # "size": "1024x1024" # 可选参数，指定输出尺寸。注意：编辑通常保持原图比例，指定尺寸可能导致裁剪或缩放
}

# 需要编辑的图片文件，以 multipart/form-data 格式发送
files = [
    (
        "image",  # 参数名称必须是 "image"
        (
            "nezha1.png",  # 文件名（可以随意命名，最好能反映内容）
            open(
                "c:\\nezha1.png",  # <-- 请替换为你的图片文件完整路径
                "rb",  # 以二进制只读模式打开文件
            ),
            "image/png",  # 文件的 MIME 类型 (image/png, image/jpeg 等)
        ),
    )
]

# 发送 POST 请求
# requests 库会自动处理 multipart/form-data 的编码
response = requests.post(url, headers=headers, data=payload, files=files)
# print原始返回内容
print(response.text)

返回示例

{
  "data": [
    {
      "url": "https://................png"  # 图片结果
    }
  ],
  "created": 1756276430
}

参考

http://imagemodels.dmxapi.com/