---
name: image-description
description: Generate image descriptions with VLM. Use when the user asks to describe images, 图像描述, 看图说话, or extract visible content from an image URL/base64/local file.
---

# 图像描述

## 何时使用

用户需要看图生成**文字描述**、或从图片提取可见内容（支持 URL、本地文件、base64）时使用。

## 用法

```bash
# 使用 URL
uv run {baseDir}/scripts/ana_image.py "https://example.com/a.jpg"

# 使用本地文件（会先上传 OSS 再调用模型）
uv run {baseDir}/scripts/ana_image.py "/path/to/local.png"

# 使用 base64（直接透传到接口）
uv run {baseDir}/scripts/ana_image.py "data:image/iVBORw0KGgoAAAANSUhEUgAA..."

```

## 输出格式

- 成功：stdout 为图片描述文本。
- 失败：stderr 报错，进程非零退出。

## 注意事项

- 本地文件须可读；由脚本上传后再请求模型。
