Gemini原生格式 网络图片内容分析 API文档

接口地址

POST https://www.dmxapi.cn/v1beta/models/{model}:generateContent

请求参数

参数	类型	必填	说明
model	string	是	使用的模型名称，如 gemini-2.5-flash
key	string	是	API密钥

请求体示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "file_data": {
                        "mime_type": "image/png",
                        "file_uri": "https://example.com/image.png"
                    }
                },
                {"text": "这张网络图片表达了什么信息？"}
            ]
        }
    ]
}

Python 调用示例

import json
import requests

# 设置模型和API密钥
model = "gemini-2.5-flash"
API_KEY = "******"  # 替换为你的实际API密钥

# 构造请求URL
url = f"https://www.dmxapi.cn/v1beta/models/{model}:generateContent?key={API_KEY}"

# 准备请求数据（使用网络图片URL）
payload = json.dumps({
    "contents": [{
        "role": "user",
        "parts": [
            {
                "file_data": {
                    "mime_type": "image/png",  # 根据实际图片类型修改
                    "file_uri": "https://example.com/image.png"  # 替换为实际图片URL
                }
            },
            {"text": "这张网络图片表达了什么信息？"}
        ]
    }]
})

# 设置请求头
headers = {
    "Content-Type": "application/json"
}

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

# 打印响应结果
print(response.text)

主要改动说明

1. 将 inline_data 改为 file_data
2. 使用 file_uri 替代 data 字段来指定网络图片URL
3. 示例问题改为针对网络图片的分析

响应说明

返回JSON格式的响应，包含对网络图片内容的分析结果。

注意事项

1. 请确保图片URL可公开访问
2. 支持的图片格式包括PNG、JPEG、WEBP等常见格式
3. 图片大小建议不超过10MB
4. 请妥善保管你的API密钥