Skip to content

OpenAI GPT image 图生图 API 文档

单图编辑修改 API 文档

概念介绍

本API提供图像编辑功能,支持:

  • 单图修改:基于提示词对单张图片进行内容修改
  • 多图合并:将多张图片按提示词要求合并处理

基础信息

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

单图修改示例

Python代码示例

python
import base64
import json
import requests

# API配置
url = "https://www.dmxapi.cn/v1/images/edits"
api_key = "sk-******"  # 替换为你的API密钥

headers = {
    "Authorization": f"Bearer {api_key}"
}

# 请求参数
payload = {
    "prompt": "给哪吒带上一个红色的鸭舌帽,风格保持不变",  # 编辑指令
    # "size": "1024x1024"  # 可选输出尺寸
}

# 准备图片文件
files = [
    ("image",  # 固定参数名
        ("nezha.png",  # 文件名
         open("/path/to/nezha.png", "rb"),  # 文件路径
         "image/png")  # 文件类型
    )
]

# 发送请求
response = requests.post(url, headers=headers, data=payload, files=files)

# 处理响应
if response.status_code == 200:
    try:
        data = response.json()
        
        # 提取base64编码的图片数据
        if data.get("data") and isinstance(data["data"], list):
            image_b64 = data["data"][0].get("b64_json")
            
            if image_b64:
                # 解码并保存图片
                with open("output.png", "wb") as f:
                    f.write(base64.b64decode(image_b64))
                print("图片保存成功")
            else:
                print("未获取到有效图片数据")
        else:
            print("响应数据结构异常")
    except json.JSONDecodeError:
        print("JSON解析失败")
else:
    print(f"请求失败: {response.status_code}")

参数说明

参数名必选类型说明
imagefile要编辑的图片文件
promptstring编辑指令描述
sizestring输出图片尺寸,如"1024x1024"

响应格式

成功响应示例:

json
{
    "data": [
        {
            "b64_json": "base64编码的图片数据"
        }
    ]
}

注意事项

  1. 图片文件需小于10MB
  2. 支持PNG/JPEG格式
  3. 编辑效果取决于提示词描述的准确性
  4. 敏感操作需确保符合内容政策

一个 Key 用全球大模型