Openai Responses 接口 文件分析API文档

接口概述

该API提供基于OpenAI模型的文件分析能力，支持上传文件并获取AI分析结果。

基本概念

• 模型选择：支持gpt系列模型
• 输入格式：支持文件URL和文本混合输入
• 角色系统：遵循OpenAI的role系统(user/assistant)

接口地址

POST https://www.dmxapi.cn/v1/responses

请求头

参数	类型	说明
Authorization	string	Bearer token
Content-Type	string	application/json

请求参数

{
    "model": "gpt-4.1",  # 指定使用的AI模型
    "input": [
        {
            "role": "user",  # 用户角色
            "content": [
                {
                    "type": "input_file",  # 文件类型输入
                    "file_url": "文件URL"  # 待分析文件地址
                },
                {
                    "type": "input_text",  # 文本类型输入
                    "text": "分析指令"  # 分析要求文本
                }
            ]
        }
    ]
}

Python示例代码

import json
import requests

# API配置
API_KEY = "sk-******"  # 替换为你的 DMXAPI 令牌
url = "https://www.dmxapi.cn/v1/responses"

headers = {
    "Authorization": f"Bearer {API_KEY}",  # 替换为你的API密钥
    "Content-Type": "application/json"
}

# 构建请求数据
payload = json.dumps({
    "model": "gpt-4.1",
    "input": [{
        "role": "user",
        "content": [
            {
                "type": "input_file",
                "file_url": "https://www.berkshirehathaway.com/letters/2024ltr.pdf"  # 替换为实际文件URL
            },
            {
                "type": "input_text",
                "text": "请分析这封信并总结要点。"  # 替换为你的分析指令
            }
        ]
    }]
})

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

# 处理响应
if response.status_code == 200:
    print("分析结果:", response.json())
else:
    print("请求失败:", response.text)

注意事项

1. 文件URL需可公开访问
2. 大文件处理可能需要更长时间
3. 请妥善保管API密钥