Openai Responses 接口图片分析API文档

接口概述

本API支持文本和图像的多模态输入，可用于图像内容描述等场景。

基础信息

• 请求方式：POST
• Base URL：https://www.dmxapi.cn
• 接口路径：/v1/responses

请求头

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-******"  # 替换为你的 DMXAPI 令牌
}

请求参数

参数名	类型	必填	说明
model	string	是	模型名称，如"gpt-4.1"
input	array	是	输入内容数组

input参数结构

{
    "role": "user",  # 角色标识
    "content": [
        {
            "type": "input_text",  # 文本类型
            "text": "描述这张图片中的内容"  # 文本内容
        },
        {
            "type": "input_image",  # 图像类型
            "image_url": "https://dmxapi.com/111.jpg"  # 图片URL
        }
    ]
}

Python调用示例

import json
import requests

# 配置API密钥
API_KEY = "******"  # 替换为你的真实API密钥

# 请求地址
url = "https://www.dmxapi.cn/v1/responses"

# 请求头设置
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

# 请求体构造
payload = {
    "model": "gpt-4.1",
    "input": [
        {
            "role": "user",
            "content": [
                {"type": "input_text", "text": "描述这张图片中的内容"},
                {
                    "type": "input_image",
                    "image_url": "https://example.com/111.jpg"  # 替换为实际图片URL
                },
            ],
        }
    ],
}

try:
    # 发送POST请求
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    
    # 检查响应状态
    response.raise_for_status()
    
    # 输出响应结果
    print("请求成功!")
    print(response.json())
    
except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")
except ValueError as e:
    print(e)

响应示例

成功响应将返回JSON格式数据，包含模型生成的描述内容。

{
    'id': 'resp_687a619027b481908f84a73cc1d8d1920b6cc565677b9a8d',
    'object': 'response',
    'created_at': 1752850834,
    'status': 'completed',
    'background': False,
    'error': None,
    'incomplete_details': None,
    'instructions': None,
    'max_output_tokens': None,
    'model': 'linkai-gpt-4.1',
    'output': [
        {
            'id': 'msg_687a61960e70819092566c0d31e7e1490b6cc565677b9a8d',
            'type': 'message',
            'status': 'completed',
            'content': [
                {
                    'type': 'output_text',
                    'annotations': [],
                    'text': '这张图片展示了一页手写的笔记，记录的是一些门的尺寸和对应的位置，内容如下：\n\n1.**第一行**\n-数字："680"\n-下方画了一个门的示意图\n-右侧写着："1560 x 2 午 框后面白"\n\n2.**第二行**\n-数字："680"\n-画了一个门的示意图\n-右侧写着："1560 x 1 午  副浴室"\n\n3.**第三行**\n-一个黑色涂抹的地方（疑似遮挡错误）\n-门的示意图\n-右侧写着："(800 x 1 午 副) 客卫"\n\n4.**第四行**\n-数字："710"\n-门的示意图\n-右侧写着："1240 木铝窗"\n\n5.**第五行**\n-数字："700"\n-门的示意图\n-右侧写着："1700 木铝窗，窗顶不强，也是落地门"\n\n6.**第六行**\n-数字："795"\n-门的示意图\n-右侧写着："2030 木铝窗 落地门"\n\n整体来看：\n-每一条目都用手绘矩形表示门或窗的形状\n-主要写明了每个门/窗的宽度、高度（单位未写但常见为毫米），以及位置或类型说明（如“框后面白”、“副浴室”、“木铝窗”、“落地门”等）\n-字迹为手写，略显潦草\n\n**用途分析：**\n这些内容看起来像是装修、建筑、门窗定制工地的尺寸手记，方便后续制作或安装使用。'
                }
            ],
            'role': 'assistant'
        }
    ],
    'parallel_tool_calls': True,
    'previous_response_id': None,
    'reasoning': {
        'effort': None,
        'summary': None
    },
    'service_tier': 'default',
    'store': True,
    'temperature': 1.0,
    'text': {
        'format': {
            'type': 'text'
        }
    },
    'tool_choice': 'auto',
    'tools': [],
    'top_p': 1.0,
    'truncation': 'disabled',
    'usage': {
        'input_tokens': 1118,
        'input_tokens_details': {
            'cached_tokens': 0
        },
        'output_tokens': 412,
        'output_tokens_details': {
            'reasoning_tokens': 0
        },
        'total_tokens': 1530
    },
    'user': None,
    'metadata': {
        
    }
}

注意事项

1. API密钥属于敏感信息，请妥善保管
2. 图片URL需要可公开访问
3. 建议对API调用进行异常处理