如何通过Facebook API上传动态GIF至页面？基于PHP Laravel

我之前也踩过这个坑！用page_id/photos接口上传GIF时，Facebook会默认将其压缩转换为静态图片，这是因为该接口主要针对静态图片优化。要实现动态GIF的正常展示，有两个可靠的方案：

方案一：使用page_id/videos接口上传（推荐） #

Facebook实际上是将动态GIF当作短视频来处理的，所以用视频接口上传能确保动效正常显示。关键是要设置content_category为GIFT，同时确保你的页面访问令牌拥有必要权限。

示例代码（Laravel HTTP客户端） #

use Illuminate\Support\Facades\Http;

// 替换为你的页面访问令牌和页面ID
$pageAccessToken = 'YOUR_PAGE_ACCESS_TOKEN';
$pageId = 'YOUR_PAGE_ID';

// 远程GIF文件上传
$response = Http::withToken($pageAccessToken)
    ->post("https://graph.facebook.com/v18.0/{$pageId}/videos", [
        'file_url' => 'https://your-domain.com/path/to/your-animated.gif',
        'content_category' => 'GIFT',
        'description' => '你的GIF描述文案'
    ]);

// 本地GIF文件上传（使用multipart表单）
// $response = Http::withToken($pageAccessToken)
//     ->attach('file', file_get_contents(storage_path('app/public/your.gif')), 'your.gif')
//     ->post("https://graph.facebook.com/v18.0/{$pageId}/videos", [
//         'content_category' => 'GIFT',
//         'description' => '本地GIF上传示例'
//     ]);

// 处理响应
if ($response->successful()) {
    $videoPostId = $response->json()['id'];
    // 上传成功，可后续操作该动态内容
} else {
    $errorDetails = $response->json();
    // 根据错误信息排查问题（比如权限不足、文件格式错误等）
}

注意事项 #

• 确保页面访问令牌拥有pages_manage_posts和pages_read_engagement权限
• GIF文件需符合Facebook的限制：建议时长不超过15秒，文件大小不超过1GB（具体以Facebook最新规则为准）
• 上传时要保证文件的MIME类型为image/gif

方案二：调整photos接口参数（不推荐，成功率低） #

如果你坚持要用photos接口，可以尝试在上传时指定type为animated_image，同时确保文件未被压缩损坏，但这个方法的稳定性较差，很多情况下还是会被转成静态图：

$response = Http::withToken($pageAccessToken)
    ->post("https://graph.facebook.com/v18.0/{$pageId}/photos", [
        'url' => 'https://your-domain.com/path/to/your.gif',
        'type' => 'animated_image',
        'published' => true
    ]);

总的来说，方案一的视频接口是最可靠的选择，Facebook官方也更推荐用这种方式处理动态GIF内容。

内容的提问来源于stack exchange，提问作者jame