Curvioo 花体字生成 API 说明
#这是什么
Curvioo 是一个免费花体字 / 签名字体生成器(curvioo.com),把普通英文文字转换成各种花体 Unicode 样式(great-vibes 等)。 它开放了一套 REST API,无需注册、无需 API Key,可直接把花体转换能力集成进自己的应用。
- 官网:https://curvioo.com/
- API 文档(中文):https://curvioo.com/cn/api/
- 技术栈:Astro 构建,托管于 Cloudflare Pages
#认证
不需要任何 API Key / Token。所有接口都是公开的 GET 请求,同域下直接调用。
#接口列表(base: https://curvioo.com)
| 路径 | 作用 |
|---|---|
/api/v1/health |
健康检查 |
/api/v1/styles/<text> |
获取所有样式及对该文本的示例输出 |
/api/v1/styles/b64/<base64text> |
同上,文本用 base64 编码(可安全传任意字符) |
/api/v1/transform/<text> |
把文字转换成全部样式 |
/api/v1/transform/<styleId>/<text> |
按样式 ID 返回单个样式,如 great-vibes |
/api/v1/transform/b64/<base64text> |
转换任意文本(base64 安全传参) |
<text>直接放在 URL path 里(如Michael)。含空格 / 特殊字符时改用b64/变体,把文本做 URL-safe base64 后传入。
#快速示例
# 转换成全部样式
curl "https://curvioo.com/api/v1/transform/Michael"
# base64 传参(TWljaGFlbA == "Michael")
curl "https://curvioo.com/api/v1/transform/b64/TWljaGFlbA"
# 只要某一种样式
curl "https://curvioo.com/api/v1/transform/great-vibes/Michael"base64 生成方式:
printf 'Michael' | base64 # -> TWljaGFlbA==(去掉末尾 = 或换 URL-safe)#额度
文档提到有"免费额度说明"(在"文档"页),但页面未列出具体数字。整体定位是免费无水印工具,个人使用量级基本无限制;大批量请高频调用时建议自行加缓存/限速,避免触发 Cloudflare 风控。
#⚠️ 实测状态(2026-07-20)
当前 API 全部端点返回 HTTP 500、空 body,实际不可用。 实测结果:
/api/v1/health、/api/v1/styles/*、/api/v1/transform/*→ 全部HTTP 500,content-length: 0/api/health(无 v1)→404
说明:/api/v1/* 路由是存在的(返回 500 而非 404,即 Cloudflare Function 被命中但内部报错),只是服务端函数目前挂了,与请求头 / UA / Accept 无关。
结论:文档描述的用法(无鉴权 GET + path 传参 + b64 变体)是清楚的,但接口现在是坏的,集成前需重新验证是否已恢复。可先跑:
curl -s -o /dev/null -w "%{http_code}\n" https://curvioo.com/api/v1/health返回 200 再接入。若持续 500,只能改用官网页面手动生成,或邮件联系 官网底部的联系邮箱。
#备注
- 保存日期:2026-07-20
- 花体本质是 Unicode 字符替换(不是图片),复制出来在 Instagram / 昵称等场景可直接用;官网另有"花体 SVG"生成器可导出矢量图。
来源:配置信息/curvioo-花体字API.md(整理于 2026-08-18)