AI图像理解

接口标识: imagunderstand 价格: 0.0002 元/次 VIP免费

接口介绍
接口文档
在线测试

接口简介

基于AI视觉大模型的图像理解服务，支持对图片内容进行智能分析和自然语言描述。传入图片和提问指令，返回准确的图像理解结果。适用于图片内容描述、智能相册分类、电商商品分析、辅助视障人士理解图片等场景。

详细介绍

## 接口介绍

AI图像理解接口基于先进的视觉大模型，能够对图片内容进行深度理解和智能分析。您可以传入任意图片，并通过自然语言指定想要了解的内容（如"这张图片里有什么？"、"图中人物在做什么？"等），接口将返回准确、清晰的图像理解结果。

## 功能特点

- **智能图像分析**：自动识别图片中的物体、场景、人物、文字等元素
- **自然语言交互**：支持自定义提问，按需获取图片特定信息
- **多格式支持**：支持 JPG、PNG 等常见图片格式，可通过 URL、Base64 或文件 ID 传入
- **结构化返回**：返回纯文本描述，易于集成和展示

## 适用场景

- 图片内容描述与标注
- 智能相册分类与检索
- 电商商品图片分析
- 辅助视障人士理解图片内容
- 教育、医疗等领域的图像解读

## 使用教程

1. 准备一张图片的公网 URL 或 Base64 编码
2. 调用接口，传入 `file` 参数（必填）和可选的 `text` 参数
3. 接口返回 AI 对图片的理解内容

## 测试
<img src="https://fujian.phpwc.com/pyapi/uploads/site/20260926/upload__1790362481_6a6603c9ab6a.png" alt="image" style="max-width: 80%; height: auto;" />
```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "content": "这张图片展示了一对中年男女在海滩上并肩散步、温馨对视的场景，整体氛围轻松、浪漫而自然。\n\n具体细节如下：\n\n- **人物**：\n  - 一位男士（左）：棕色短发略显蓬松，面带微笑，目光温柔地注视着身旁的女士。他身穿浅蓝色亚麻长袖衬衫（袖子卷至前臂），搭配米白色休闲裤，双手插在裤袋中，姿态放松。\n  - 一位女士（右）：棕色中长发被海风吹拂，同样微笑回望男士，神情愉悦。她穿着米白色V领亚麻上衣（袖子也卷起），搭配同色系亚麻长裤，一只手插在口袋里。\n  - 两人衣着风格协调，材质轻盈透气，适合海边度假，体现简约自然的生活美学。\n\n- **环境**：\n  - 背景是晴朗的蓝天与碧蓝的大海，海浪轻柔拍打沙滩。\n  - 远处可见连绵起伏的绿色山丘（可能是地中海沿岸地貌）。\n  - 沙滩为浅黄色细沙，干净整洁，无其他游客或杂物，营造出私密宁静的氛围。\n\n- **光线与构图**：\n  - 自然光充足柔和，应为白天（可能上午或下午），人物面部光影自然。\n  - 采用中景构图，人物居中偏左，视线互动成为画面焦点，传递出亲密、默契的情感联结。\n\n✅ 总体而言，这是一张高质量的生活方式类摄影图，常用于表现健康关系、旅行度假、品牌服饰（如亚麻休闲装）或情感广告等场景。"
  },
  "request_id": "tg0724751792131988658135"
}
```

接口地址： https://www.phpwc.cn/api/imagunderstand

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	要传入的图像，公网URL / Base64(data:开头) / 文件ID(fileid_开头)
`text`	string	选填	`这张图片里有什么？`	对图片的提问或理解指令，不传则默认分析图片内容

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`content`	string	AI返回的图像理解内容
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试