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/v2

Autenticació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

PlanRequests/minRequests/mes
Free10500
Pro6010,000
Business300100,000
EnterpriseIlimitadoIlimitado

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