v2.1 · Estable
Referencia de API
La API de FontGenerator te permite integrar generación de tipografías directamente en tus aplicaciones. RESTful, con respuestas JSON y soporte para SVG, PNG y WebP.
ℹ️
La URL base para todos los endpoints es
https://api.fontgenerator.io/v2Autenticación
Todas las solicitudes requieren una API key enviada en el header Authorization:
HTTP Header
Authorization: Bearer fg_live_xxxxxxxxxxxxxxxxxxxxxxxx
POST /generate
Genera una fuente con el texto y estilo especificados. Retorna URLs a los archivos generados.
POST
/generate
Parámetros del cuerpo
| Parámetro | Tipo | Descripción |
|---|---|---|
| text required | string | El texto a renderizar (máx. 100 caracteres) |
| style | string | ID del estilo de fuente. Default: modern |
| size | integer | Tamaño en px (20–600). Default: 120 |
| color | string | Código hex (#RRGGBB) o nombre de gradiente |
| format | string | Formato de salida: svg, png, webp |
| transparent | boolean | Fondo transparente. Default: true |
Ejemplo de solicitud
JavaScript
const response = await fetch('https://api.fontgenerator.io/v2/generate', { method: 'POST', headers: { 'Authorization': 'Bearer fg_live_xxx', 'Content-Type': 'application/json', }, body: JSON.stringify({ text: 'Aurora', style: 'modern', size: 120, color: '#7C3AED', format: 'svg', transparent: true, }), }); const data = await response.json(); // { url: 'https://cdn.fontgenerator.io/...', width: 800, height: 200 }
Respuesta
JSON
{
"id": "fg_gen_abc123",
"url": "https://cdn.fontgenerator.io/output/abc123.svg",
"width": 800,
"height": 200,
"format": "svg",
"style": "modern",
"generated_at": "2026-04-29T12:00:00Z",
"expires_at": "2026-05-29T12:00:00Z"
}
GET /styles
Lista todos los estilos disponibles con sus metadatos.
GET
/styles
Límites de tasa
| Plan | Requests/min | Requests/mes |
|---|---|---|
| Free | 10 | 500 |
| Pro | 60 | 10,000 |
| Business | 300 | 100,000 |
| Enterprise | Ilimitado | Ilimitado |
Errores
Todos los errores usan códigos HTTP estándar y retornan un cuerpo JSON con detalle:
JSON — Error 401
{
"error": {
"code": "unauthorized",
"message": "API key inválida o expirada",
"docs": "https://fontgenerator.io/docs/errors#401"
}
}
SDKs Oficiales
🟨
JavaScript
npm install @fontgen/js
🐍
Python
pip install fontgenerator
♦️
Ruby
gem install fontgenerator
🐘
PHP
composer require fontgen/php