Skip to content

Openai请求格式 网络图片分析 API 文档

接口说明

通过多模态AI模型分析图片内容,理解图片、提取图片信息,包括OCR功能。

注意:推荐使用 Openai Responses 新版接口,兼容性更好

旧版接口偶尔会遇到图片识别报错,但无法查明原因,请改用新版接口进行图片分析: 文档:http://doc.dmxapi.cn/res-url-image.html

主流图片分析模型

模型名称描述
gpt-4o目前图片分析调用量最大的模型,稳定、并发高
gemini-2.5-flash谷歌旗舰模型,速度快,性价比好
claude-sonnet-4-20250514图片分析做的不错,但性价比略差
doubao-1.5-vision-pro-250328国内图片分析主流模型,性价比好,稳定、并发高

基础信息

  • Base URL: https://www.dmxapi.cn/
  • 请求方式: POST
  • Content-Type: application/json

接口地址

POST /v1/chat/completions

请求头

参数类型必填说明
AuthorizationstringBearer token,格式:Bearer ******
Content-Typestring固定值:application/json
User-Agentstring客户端标识

请求参数

json
{
  "model": "gemini-2.0-flash-thinking-exp-1219",
  "messages": [
    {
      "role": "system",
      "content": [
        {"type": "text", "text": "你是一个图片分析助手。"}
      ]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "图片URL"
          }
        },
        {
          "type": "text",
          "text": "分析提示词"
        }
      ]
    }
  ],
  "temperature": 0.1,
  "user": "DMXAPI"
}

参数说明

参数类型必填说明
modelstring模型名称,推荐:gemini-2.5-flashgpt-4o
messagesarray消息内容数组
temperaturefloat生成文本的随机性,0-1之间
userstring用户标识

Python 调用示例

python
import requests

# API配置
BASE_URL = "https://www.dmxapi.cn/"
API_ENDPOINT = BASE_URL + "v1/chat/completions"
API_KEY = "sk-******"  # 替换为你的API密钥
IMAGE_URL = "https://dmxapi.com/111.jpg"  # 替换为你的图片URL

def analyze_image(image_url, prompt):
    """
    图片分析函数
    :param image_url: 图片URL
    :param prompt: 分析提示词
    :return: 分析结果文本
    """
    payload = {
        "model": "gemini-2.0-flash-thinking-exp-1219",
        "messages": [
            {
                "role": "system",
                "content": [{"type": "text", "text": "你是一个图片分析助手。"}]
            },
            {
                "role": "user",
                "content": [
                    {"type": "image_url", "image_url": {"url": image_url}},
                    {"type": "text", "text": prompt}
                ]
            }
        ],
        "temperature": 0.1
    }
    
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}"
    }

    try:
        response = requests.post(API_ENDPOINT, headers=headers, json=payload)
        response.raise_for_status()
        return response.json()["choices"][0]["message"]["content"]
    except Exception as e:
        print(f"请求失败: {e}")
        return None

# 使用示例
if __name__ == "__main__":
    result = analyze_image(IMAGE_URL, "请描述这张图片的内容")
    if result:
        print("分析结果:", result)

常见错误码

状态码说明
400请求参数错误,看看图片是不是太大了
500服务器内部错误

一个 Key 用全球大模型