发送图片消息

通过公网图片 URL 向好友或群聊发送图片消息。

菜单里的「发送图片」是 /sendImage2，两个接口参数相同。

性能建议

在已授权场景中复用媒体素材时，请先阅读 API 使用与安全。

接口地址： POST /sendImage

前置条件

• 微信实例已登录，并已获得可用 wId。
• 接收方 wcId 可以是好友微信 ID，也可以是群 ID。
• content 需要是微信客户端可访问的公网图片 URL。
• 图片建议使用稳定 CDN，避免临时链接过期。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方微信 ID 或群 ID
content	是	string	图片 URL。图片不能超过 5M，超过返回「图片不可超过5M，请压缩」

响应参数

参数名	类型	说明
code	string	1000 成功；其他值都是失败，通常是 1001
message	string	反馈信息
data	null	无业务数据返回

请求示例

HTTP

POST {BASE_URL}/sendImage
Authorization: Bearer <你的调用凭证>
Content-Type: application/json

{
 "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
 "wcId": "LoChaX",
 "content": "http://photocdn.sohu.com/20120323/Img338614056.jpg"
}

curl

curl -X POST '{BASE_URL}/sendImage' \
  -H 'Authorization: Bearer <你的调用凭证>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
 "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
 "wcId": "LoChaX",
 "content": "http://photocdn.sohu.com/20120323/Img338614056.jpg"
}'

Python

import requests

url = "{BASE_URL}/sendImage"
headers = {"Authorization": "Bearer <你的调用凭证>", "Content-Type": "application/json"}
body = """{
 "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
 "wcId": "LoChaX",
 "content": "http://photocdn.sohu.com/20120323/Img338614056.jpg"
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/sendImage";
String body = "{\n" +
    " \"wId\": \"0000016e-63eb-f319-0001-ed01076abf1f\",\n" +
    " \"wcId\": \"LoChaX\",\n" +
    " \"content\": \"http://photocdn.sohu.com/20120323/Img338614056.jpg\"\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的调用凭证>")
    .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());

PHP

<?php

$url = '{BASE_URL}/sendImage';
$body = <<<'JSON'
{
 "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
 "wcId": "LoChaX",
 "content": "http://photocdn.sohu.com/20120323/Img338614056.jpg"
}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的调用凭证>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

成功响应

{
 "message": "发送成功",
 "code": "1000",
 "data": null
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 新接入请使用发送图片，本页只为兼容旧接入保留。
• 图片 URL 需要稳定可访问，避免因防盗链、过期链接或非公网地址导致发送失败。
• 批量发送同一图片时，建议复用稳定素材地址，并控制发送频率。