Social Image Render API

Generate polished social media and Open Graph images from structured JSON using ready-made templates or custom layouts.

原始信息汇总

数据集概述

基本信息

• 数据集名称：Social Image Render API
• API类型：社交媒体图像渲染服务
• 所属类别：Media（媒体）
• 提供者：josiahxayavong
• 订阅人数：1
• API版本：0.1.0（当前）

核心技术特点

功能定位：将JSON数据转换为精美的社交媒体图片，支持多种尺寸模板。

支持的图片尺寸预设：

• OG卡（Open Graph）：1200x630（默认）
• 正方形帖子：1080x1080
• 故事图片：1080x1920
• Twitter头部横幅：1500x500

内置模板（共6种）：

1. gradient_announcement - 渐变公告
2. minimal_light - 极简亮色
3. dark_panel - 深色面板
4. quote_card - 引用卡片
5. blog_header - 博客头部
6. photo_overlay - 照片覆盖

布局系统：提供结构化的JSON布局系统，支持嵌套框、文本、图片、渐变、圆角等元素，但刻意不使用任意HTML/CSS，以保证输出确定性和速度。

图片支持：每张卡片最多支持3张调用方提供的图片（HTTPS PNG/JPEG格式，单张最大2MB），可用于头像、Logo、照片背景等。

API端点

方法	端点	功能说明
POST	/v1/render	渲染一张社交卡片，支持模板+数据或内联布局对象
GET	/v1/templates	列出6种内置模板及其必填/可选字段、图片字段和支持的尺寸

响应模式

• 默认模式：二进制 image/png，可直接接入工作流
• JSON模式：通过 "response_format": "json_base64" 返回包含base64编码PNG的JSON封装

技术限制

1. 字符支持：仅支持拉丁语、西里尔语和希腊语脚本（使用Inter字体），不支持Emoji和CJK文本，不支持的字符将渲染为占位框
2. 渲染限制：不支持任意HTML/CSS渲染，布局使用文档化的JSON schema
3. 无状态服务：不保存模板、无账户体系、不提供图片托管，PNG返回后不存储任何内容
4. 请求大小限制：请求体最大256KB，布局复杂度有明确边界，超出限制会返回清晰的4xx错误

错误处理机制

采用结构化JSON错误，包含稳定错误码：

• validation_error（400）- 验证错误
• unknown_template（404）- 未知模板
• payload_too_large（413）- 请求体过大
• render_limit / image_fetch_failed（422）- 渲染限制/图片获取失败

每次响应都会携带请求ID（request_id）用于追踪。

定价方案

套餐	月费	包含量	适用场景
BASIC	$0/月	60次渲染/月	试用所有模板和尺寸
PRO	$9/月	2,000次渲染/月	日常自动化发布
ULTRA	$29/月	12,000次渲染/月	多渠道/多网站批量使用

所有套餐均为硬性限额，配额用尽后请求将返回错误直到下一个周期，不会产生超额费用。

认证方式

在RapidAPI平台订阅后，每次请求在HTTP头中携带 X-RapidAPI-Key 即可完成认证。

典型应用场景

• 为博客文章或产品页面自动生成Open Graph图片
• 在n8n、Make、Zapier等自动化平台中创建品牌化社交媒体卡片
• 从CMS或电子表格生成引用卡片和公告图文
• 使用同一JSON源生成故事格式推广图片和头部横幅

服务性能指标

• 服务等级：100%
• 延迟：134ms
• 典型渲染延迟：远低于0.5秒
• 输出确定性：相同请求始终生成相同的PNG