头像与图形
这是什么 / 何时用
生成/获取头像、图标、截图等图片资源:文字头像、二维码、国旗、浏览器与卡组织图标、远程图片抓取、站点 favicon 与网页截图。客户端与服务端都可用。
前置
- 2.6.0 安全默认值:远程 Avatar Image、Favicon、Screenshot 默认不可用(外部 URL 拒绝本机/私网/元数据地址的 SSRF 防护默认收紧)——不要建议长期关闭防护来恢复旧行为。
使用骨架
avatars.getInitials({ name, ... })(文字头像)、avatars.getQR(...)(二维码)、avatars.getFlag({ code })(国旗)、avatars.getCreditCard({ code })(卡组织图标)、avatars.getBrowser({ code })(浏览器图标)、avatars.getImage({ url }) / getFavicon({ url }) / getScreenshot({ url })(远程资源,默认关闭,见上)。
关键参数与返回
- 返回图片字节(可设宽度/高度/质量等渲染参数)。
错误与边界
- 远程 Avatars 类接口默认关闭时返回错误——这是 2.6.0 安全默认值,不是故障。
各语言调用示例
客户端与服务端均可用;Web 页签走用户 Session。远程 Image / Favicon / Screenshot 默认不可用(2.6.0 安全默认值,见「错误与边界」)。
- Node.js(Server)
- Web(用户 Session)
- Java
- Python
- Go
- REST(curl)
import { Avatars } from 'agentbase-node-sdk';
const avatars = new Avatars(client);
await avatars.getInitials({ name: 'Ada Lovelace' }); // 文字头像,可设宽度/高度/质量等渲染参数
await avatars.getFlag({ code: 'cn' }); // 国旗(ISO Alpha-2)
// getQR / getCreditCard / getBrowser / getImage / getFavicon / getScreenshot 同理
// 2.6.0 安全默认值:远程 Image / Favicon / Screenshot 默认不可用(SSRF 防护收紧),不是故障import { Avatars } from 'agentbase-web-sdk';
const avatars = new Avatars(client);
await avatars.getInitials({ name: 'Ada Lovelace' });avatars.getInitials("Ada Lovelace", null, null, null); // 文字头像,可设宽度/高度/背景
avatars.getFlag(io.agentbase.enums.Flag.CHINA, null, null, null); // 国旗(ISO Alpha-2)
// getQR / getCreditCard / getBrowser / getImage / getFavicon / getScreenshot 同为位置参数,返回图片字节from agentbase.services.avatars import Avatars
avatars = Avatars(client) # 返回图片字节
avatars.get_initials(name='Ada Lovelace')
avatars.get_flag(code='cn') # 国旗(ISO Alpha-2);远程 image / favicon / screenshot 默认不可用(2.6.0 安全默认值)avatars := agentbase.NewAvatars(cl) // facade 构造器;cl 为已装载 API Key 的 Client
img, _ := avatars.GetInitials(avatars.WithGetInitialsName("Ada Lovelace")) // 文字头像,可设 Width/Height/Background
_ = img
avatars.GetFlag("cn") // 国旗(ISO Alpha-2);另有 GetQR / GetCreditCard / GetBrowser / GetImage / GetFavicon / GetScreenshot
// 2.6.0 安全默认值:远程 Image / Favicon / Screenshot 默认不可用(SSRF 防护收紧),不是故障curl -sS "$APPBASE_ENDPOINT/v1/avatars/initials?name=Ada" \
-H "X-Appwrite-Project: $APPBASE_PROJECT_ID" -H "X-Appwrite-Key: $APPBASE_API_KEY" -o initials.png
# 国旗:GET /v1/avatars/flags/{code};二维码:GET /v1/avatars/qr;浏览器/卡组织图标:/avatars/browsers/{code}、/avatars/credit-cards/{code}
# 远程资源:GET /v1/avatars/image、/favicon、/screenshots(2.6.0 默认不可用)SDK 类别差异
- Server SDK / Console SDK / 客户端 SDK:均可用。
事实源
skills/ob-agentbase/references/release-2.6.0.md(远程 Avatar/Favicon/Screenshot 默认收紧)- appbase v2.7.0(tag v2.7.0)
- agentbase-sdks v2.7.0 specs(
packages/sdks/server-nodejs/src/services/avatars.ts方法面)