DMXAPI

Appearance

Agnes Image 2.1 Flash 图生图 API 文档 ​

Sapiens AI 出品的升级版图像生成模型，支持基于输入图片进行智能编辑，返回图片格式支持 URL 和 Base64 两种输出

📌 接口地址 ​

text
https://www.dmxapi.cn/v1/images/generations

🎨 模型列表 ​

  • agnes-image-2.1-flash

💻 Python 示例代码 ​

python
"""
┌─────────────────────────────────────────────────────────────────┐
│  Agnes Image 2.1 Flash 图生图 API 调用示例 - URL 输出              │
│                                                                 │
│  功能说明：传入参考图片进行图生图，返回图片下载链接                  │
└─────────────────────────────────────────────────────────────────┘
"""

import json
import base64
import requests

# ═══════════════════════════════════════════════════════════════════════════════
#  第一部分：用户配置区（按需修改以下内容）
# ═══════════════════════════════════════════════════════════════════════════════

# 接口地址
url = "https://www.dmxapi.cn/v1/images/generations"

# 请求头（请替换为你自己的 DMXAPI 密钥）
headers = {
    "Content-Type": "application/json",
    "Authorization": "sk-**********************************"
}

# 请求体
data = {
    # 模型名称
    "model": "agnes-image-2.1-flash",

    # 编辑指令（描述你希望如何编辑输入图片）
    "prompt": "Transform the scene into a rain-soaked cyberpunk night with neon reflections while preserving the original composition",

    # 输出图片分辨率档位（可选值：1K、2K、3K、4K）
    "size": "1K",

    # 输出图片宽高比（可选值：1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9，默认 1:1）
    #
    # ┌──────────┬─────────────┬─────────────┬─────────────┬─────────────┐
    # │ 宽高比    │ 1K          │ 2K          │ 3K          │ 4K          │
    # ├──────────┼─────────────┼─────────────┼─────────────┼─────────────┤
    # │ 1:1      │ 1024x1024   │ 2048x2048   │ 3072x3072   │ 4096x4096   │
    # │ 3:4      │ 864x1152    │ 1728x2304   │ 2592x3456   │ 3456x4608   │
    # │ 4:3      │ 1152x864    │ 2304x1728   │ 3456x2592   │ 4608x3456   │
    # │ 16:9     │ 1312x736    │ 2624x1472   │ 3936x2208   │ 5248x2944   │
    # │ 9:16     │ 736x1312    │ 1472x2624   │ 2208x3936   │ 2944x5248   │
    # │ 2:3      │ 832x1248    │ 1664x2496   │ 2496x3744   │ 3328x4992   │
    # │ 3:2      │ 1248x832    │ 2496x1664   │ 3744x2496   │ 4992x3328   │
    # │ 21:9     │ 1568x672    │ 3136x1344   │ 4704x2016   │ 6272x2688   │
    # └──────────┴─────────────┴─────────────┴─────────────┴─────────────┘
    "ratio": "1:1",

    # ⚠️ 注意：image 和 response_format 都需放入 extra_body 内部，不可放在请求体顶层
    "extra_body": {
        # image - 输入图片（支持两种写法，代码会自动识别）
        # • 网络图片：直接填 URL，如 "https://example.com/input-image.png"
        # • 本地图片：直接填文件路径，如 "test/example.jpg"
        "image": [
            "https://example.com/input-image.png"
        ],

        # response_format - 返回格式
        # • url      → 返回图片下载链接
        # • b64_json → 返回 Base64 编码的 JSON 格式图像数据
        "response_format": "url"
    }
}

# ═══════════════════════════════════════════════════════════════════════════════
#  第二部分：请求逻辑（以下内容无需修改）
# ═══════════════════════════════════════════════════════════════════════════════

def encode_image_to_base64(image_path):
    """将本地图片编码为 Base64 格式的 Data URI"""
    with open(image_path, "rb") as image_file:
        encoded = base64.b64encode(image_file.read()).decode('utf-8')
        ext = image_path.split('.')[-1].lower()
        if ext == 'jpg':
            ext = 'jpeg'
        return f"data:image/{ext};base64,{encoded}"

# 自动识别输入图片类型：网络 URL 直接使用，本地路径编码为 Data URI
data["extra_body"]["image"] = [
    item if item.startswith(("http://", "https://")) else encode_image_to_base64(item)
    for item in data["extra_body"]["image"]
]

# 发送 POST 请求到 API
response = requests.post(url, headers=headers, json=data)

# 输出响应信息
print(f"状态码: {response.status_code}")
print(f"响应内容:\n{json.dumps(response.json(), indent=2, ensure_ascii=False)}")
python
"""
┌─────────────────────────────────────────────────────────────────┐
│  Agnes Image 2.1 Flash 图生图 API 调用示例 - Base64 输出           │
│                                                                 │
│  功能说明：传入参考图片进行图生图，返回 Base64 编码的图像数据        │
└─────────────────────────────────────────────────────────────────┘
"""

import json
import base64
import requests

# ═══════════════════════════════════════════════════════════════════════════════
#  第一部分：用户配置区（按需修改以下内容）
# ═══════════════════════════════════════════════════════════════════════════════

# 接口地址
url = "https://www.dmxapi.cn/v1/images/generations"

# 请求头（请替换为你自己的 DMXAPI 密钥）
headers = {
    "Content-Type": "application/json",
    "Authorization": "sk-**********************************"
}

# 请求体
data = {
    # 模型名称
    "model": "agnes-image-2.1-flash",

    # 编辑指令（描述你希望如何编辑输入图片）
    "prompt": "Make the object orange while preserving the original composition",

    # 输出图片分辨率档位（可选值：1K、2K、3K、4K）
    "size": "1K",

    # 输出图片宽高比（可选值：1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9，默认 1:1）
    #
    # ┌──────────┬─────────────┬─────────────┬─────────────┬─────────────┐
    # │ 宽高比    │ 1K          │ 2K          │ 3K          │ 4K          │
    # ├──────────┼─────────────┼─────────────┼─────────────┼─────────────┤
    # │ 1:1      │ 1024x1024   │ 2048x2048   │ 3072x3072   │ 4096x4096   │
    # │ 3:4      │ 864x1152    │ 1728x2304   │ 2592x3456   │ 3456x4608   │
    # │ 4:3      │ 1152x864    │ 2304x1728   │ 3456x2592   │ 4608x3456   │
    # │ 16:9     │ 1312x736    │ 2624x1472   │ 3936x2208   │ 5248x2944   │
    # │ 9:16     │ 736x1312    │ 1472x2624   │ 2208x3936   │ 2944x5248   │
    # │ 2:3      │ 832x1248    │ 1664x2496   │ 2496x3744   │ 3328x4992   │
    # │ 3:2      │ 1248x832    │ 2496x1664   │ 3744x2496   │ 4992x3328   │
    # │ 21:9     │ 1568x672    │ 3136x1344   │ 4704x2016   │ 6272x2688   │
    # └──────────┴─────────────┴─────────────┴─────────────┴─────────────┘
    "ratio": "1:1",

    # ⚠️ 注意：image 和 response_format 都需放入 extra_body 内部，不可放在请求体顶层
    "extra_body": {
        # image - 输入图片（支持两种写法，代码会自动识别）
        # • 网络图片：直接填 URL，如 "https://example.com/input-image.png"
        # • 本地图片：直接填文件路径，如 "test/example.jpg"
        "image": [
            "https://example.com/input-image.png"
        ],

        # response_format - 返回格式
        # • url      → 返回图片下载链接
        # • b64_json → 返回 Base64 编码的 JSON 格式图像数据
        "response_format": "b64_json"
    }
}

# ═══════════════════════════════════════════════════════════════════════════════
#  第二部分：请求逻辑（以下内容无需修改）
# ═══════════════════════════════════════════════════════════════════════════════

def encode_image_to_base64(image_path):
    """将本地图片编码为 Base64 格式的 Data URI"""
    with open(image_path, "rb") as image_file:
        encoded = base64.b64encode(image_file.read()).decode('utf-8')
        ext = image_path.split('.')[-1].lower()
        if ext == 'jpg':
            ext = 'jpeg'
        return f"data:image/{ext};base64,{encoded}"

# 自动识别输入图片类型：网络 URL 直接使用，本地路径编码为 Data URI
data["extra_body"]["image"] = [
    item if item.startswith(("http://", "https://")) else encode_image_to_base64(item)
    for item in data["extra_body"]["image"]
]

# 发送 POST 请求到 API
response = requests.post(url, headers=headers, json=data)

# 输出响应信息（data[0].b64_json 即为 Base64 编码的图像数据）
print(f"状态码: {response.status_code}")
print(f"响应内容:\n{json.dumps(response.json(), indent=2, ensure_ascii=False)}")

📤 返回示例 ​

json
状态码: 200
响应内容:
{
  "data": [
    {
      "url": "https://platform-outputs.agnes-ai.space/images/i2i/task_fUKidMbDZxEc4Qqe83xHUAemTn0LYVrg/output.png",
      "b64_json": "",
      "revised_prompt": ""
    }
  ],
  "created": 1784883981,
  "task_id": "task_fUKidMbDZxEc4Qqe83xHUAemTn0LYVrg"
}
json
状态码: 200
响应内容:
{
  "data": [
    {
      "url": "",
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": ""
    }
  ],
  "created": 1784884012,
  "task_id": "task_HxWzaqG7MdrMUD2bk26r0dgwHpaSNSUF"
}

© 2026 DMXAPI Agnes Image 2.1 Flash 图生图 API 文档

一个 Key 用全球大模型

Copyright © 2025 DMXAPI 版权所有