图片描述
分析图片内容,自动生成描述性文本。可用于大规模图片库的自动标签化、搜索摘要生成,以及无障碍体验优化等场景。
典型应用场景
- 智能资产管理:为海量图片库自动生成标签、标题与搜索摘要
- 辅助阅读:为视觉障碍者生成图片的语音描述文本,增强无障碍体验
本页使用的 API 参考 POST /images/captions
图片传入方式
图片参数支持三种格式,可根据使用场景灵活选择:
- 前置任务结果:将上一步任务返回的
asset_path直接作为字段值,适合多步流程串联(如先文生图、再图片编辑) - Base64 编码:传入图片文件内容的 base64 字符串(不含
data:前缀),适合直接传入本地文件 - 公网 URL:传入
https://开头的可公开访问图片链接,系统自动下载处理
基础示例
bash
curl -X POST 'https://api.v2fun.ai/api/v1/images/captions' \
-H "Authorization: Bearer $V2FUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input_image": "images/example.png",
"language": "Chinese"
}'javascript
// Node.js 18+; set V2FUN_API_KEY in your environment.
const response = await fetch("https://api.v2fun.ai/api/v1/images/captions", {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.V2FUN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"input_image": "images/example.png",
"language": "Chinese"
}),
});
const data = await response.json();python
import os
import requests
resp = requests.post(
"https://api.v2fun.ai/api/v1/images/captions",
headers={
"Authorization": f'Bearer {os.environ["V2FUN_API_KEY"]}',
"Content-Type": "application/json",
},
json={
"input_image": "images/example.png",
"language": "Chinese"
},
)
print(resp.json())java
import java.net.URI;
import java.net.http.*;
HttpClient client = HttpClient.newHttpClient();
String body = "{\"input_image\":\"images/example.png\",\"language\":\"Chinese\"}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.v2fun.ai/api/v1/images/captions"))
.header("Authorization", "Bearer " + System.getenv("V2FUN_API_KEY"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = client.send(
request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());核心用例
智能图像描述
支持指定输出语言。AI 会详细描述图片内容,包括场景中的每个细节,帮助您在不看图的情况下也能掌握核心信息。
bash
curl -X POST 'https://api.v2fun.ai/api/v1/images/captions' \
-H "Authorization: Bearer $V2FUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input_image": "https://asset.v2fun.ai/upload/img-basic.png",
"language": "en"
}'javascript
// Node.js 18+; set V2FUN_API_KEY in your environment.
const response = await fetch("https://api.v2fun.ai/api/v1/images/captions", {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.V2FUN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"input_image": "https://asset.v2fun.ai/upload/img-basic.png",
"language": "en"
}),
});
const data = await response.json();python
import os
import requests
resp = requests.post(
"https://api.v2fun.ai/api/v1/images/captions",
headers={
"Authorization": f'Bearer {os.environ["V2FUN_API_KEY"]}',
"Content-Type": "application/json",
},
json={
"input_image": "https://asset.v2fun.ai/upload/img-basic.png",
"language": "en"
},
)
print(resp.json())java
import java.net.URI;
import java.net.http.*;
HttpClient client = HttpClient.newHttpClient();
String body = "{\"input_image\":\"https://asset.v2fun.ai/upload/img-basic.png\",\"language\":\"en\"}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.v2fun.ai/api/v1/images/captions"))
.header("Authorization", "Bearer " + System.getenv("V2FUN_API_KEY"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = client.send(
request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());输入图片

输出结果
Golden Sunburst Over Mountain Ridges
