图片描述

分析图片内容，自动生成描述性文本。可用于大规模图片库的自动标签化、搜索摘要生成，以及无障碍体验优化等场景。

典型应用场景

• 智能资产管理：为海量图片库自动生成标签、标题与搜索摘要
• 辅助阅读：为视觉障碍者生成图片的语音描述文本，增强无障碍体验

本页使用的 API 参考 POST /images/captions

图片传入方式

图片参数支持三种格式，可根据使用场景灵活选择：

• 前置任务结果：将上一步任务返回的 asset_path 直接作为字段值，适合多步流程串联（如先文生图、再图片编辑）
• Base64 编码：传入图片文件内容的 base64 字符串（不含 data: 前缀），适合直接传入本地文件
• 公网 URL：传入 https:// 开头的可公开访问图片链接，系统自动下载处理

基础示例

cURL

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

const response = await fetch('https://api.v2fun.ai/api/v1/images/captions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer $V2FUN_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input_image": "images/example.png",
    "language": "Chinese"
  }),
});
const data = await response.json();

Python

import requests

resp = requests.post(
    'https://api.v2fun.ai/api/v1/images/captions',
    headers={
        'Authorization': 'Bearer $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 $V2FUN_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

核心用例

智能图像描述

支持指定输出语言。AI 会详细描述图片内容，包括场景中的每个细节，帮助您在不看图的情况下也能掌握核心信息。

cURL

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

const response = await fetch('https://api.v2fun.ai/api/v1/images/captions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer $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 requests

resp = requests.post(
    'https://api.v2fun.ai/api/v1/images/captions',
    headers={
        'Authorization': 'Bearer $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 $V2FUN_API_KEY")
    .header("Content-Type", "application/json")
    .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