התחברות
התחברות
Genera fuentes, consulta glifos y gestiona la entrega desde tu código. El mismo motor que la app; solo necesitas un bearer token.
Todas las solicitudes usan un bearer token en la cabecera Authorization. Guárdalo en el servidor.
Inicia sesión para generar una clave API activa — es gratis, todos los planes incluyen acceso a la API.
Inicia sesión para obtener tu claveLas solicitudes se limitan por clave API. Superar el límite devuelve 429 Too Many Requests con una Retry-After. Los límites aumentan según tu plan:
| Crear fuente · todo lo demás | |
| Starter | 60 · 600 / min |
| Pro | 200 · 2 000 / min |
| Agency | 600 · 6 000 / min |
¿Necesitas más capacidad? Mejora tu plan.
Genera una fuente completa a partir de un prompt de texto. Devuelve una tarea cuyo estado puedes ir consultando, o esperar el aviso por webhook.
| promptobligatorio | Descripción en lenguaje sencillo de la fuente. Optional when reference_image_url is set. |
| reference_image_url | Imagen de referencia de estilo (PNG/JPG/WEBP) — una URL pública directa. Nunca la almacenamos; reenviamos el enlace tal cual al motor de renderizado, igual que el «screenshot to font» de los plugins de Figma/Chrome. |
| languages | Array de códigos ISO — por defecto ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | p. ej. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Consulta el estado de una fuente y las URL de descarga (TTF / WOFF2 / variable).
Descarga el archivo de fuente ya generado en un formato concreto (ttf/otf/woff/woff2) — el mismo archivo que produce el botón de descarga de Studio.
Todos los códigos de idioma ISO-2 admitidos, con el número de glifos por escritura y la dirección del texto — úsalo para construir un array "languages" válido.
Tus últimas 100 tareas de fuentes — estado, modelo, origen y un enlace a la página de cada fuente.
La generación es asíncrona. Tras el POST a generate, consulta GET /api/public/status?link=… cada pocos segundos hasta que el estado sea font_ready (o failed).
| status | queued · processing · font_ready · failed |
| progress | { total, completed, failed } — cuántos atlas de glifos están terminados |
| fonts | URLs directas ttf/otf/woff/woff2, presentes cuando status = font_ready. |
Consultar cada 3–5 segundos es más que suficiente — una familia completa suele terminar en menos de un par de minutos. Las URLs de los archivos de fuente son estáticas y no requieren autenticación una vez devueltas.
Todos los errores siguen una estructura JSON coherente: { "success": false, "error": "…" }.
| 400 | Solicitud incorrecta — campos faltantes o no válidos. Revisa la error para más detalles. |
| 401 | No autorizado — falta o no es válida la Authorization cabecera. |
| 402 | Pago requerido — cuota de glifos agotada. Recarga en la página de Planes. |
| 403 | Prohibido — el enlace pertenece a otra cuenta. |
| 404 | No encontrado — el ID de la fuente no existe o pertenece a otra cuenta. |
| 429 | Demasiadas solicitudes — límite de solicitudes alcanzado. Reintenta después de Retry-After. |
| 500 | Error interno — algo salió mal por nuestra parte. Reintentar tras unos segundos suele funcionar. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) permite que los agentes de código con IA — Claude Code, Cursor, Codex y otros — llamen a YoFont directamente mientras trabajan: generar una fuente a mitad de la conversación, esperar a que se construya y colocar el archivo directamente en tu proyecto. Sin copiar y pegar comandos curl.
Cada llamada a una herramienta MCP es una envoltura fina y transparente sobre los mismos endpoints REST documentados en la pestaña API — misma autenticación, mismos límites de solicitudes, misma validación. El servidor MCP no hace nada que no esté también documentado en REST.
Copia el prompt de abajo y pégalo en Claude Code, Cursor o Codex. Tu agente registrará el servidor MCP de YoFont por sí mismo y lo verificará — sin editar archivos de configuración a mano.
Consigue tu clave en la sección Autenticación de la pestaña API.
Apunta tu cliente MCP a https://yofont.com/api/public/mcp. Usa el transporte Streamable HTTP (modo de respuesta JSON) — una solicitud JSON-RPC 2.0 por llamada, sin sesión ni socket que mantener abierto.
| Transporte | Streamable HTTP (JSON-RPC 2.0 sobre POST). Métodos: initialize, ping, tools/list, tools/call. |
| Autenticación | La misma clave API que en REST — envíala como cabecera en cada solicitud: Authorization: Bearer yf_live_.... |
Cinco herramientas, una a una con los endpoints REST de la pestaña API — nada existe en MCP que no exista también en REST puro.
Genera una familia de fuente completamente nueva a partir de un prompt y/o una imagen de referencia. Devuelve de inmediato un enlace para consultar el estado — es una tarea asíncrona, no una llamada bloqueante.
| prompt | Descripción del estilo en lenguaje sencillo. Opcional si se indica reference_image_url. |
| reference_image_url | URL pública directa de la imagen — solo necesita ser accesible públicamente en el momento de la llamada. |
| languages, weights, glyph_types, model_tier | Misma estructura y valores por defecto que el endpoint REST — consulta la sección «Crear fuente» de la pestaña API. |
Consulta el progreso de construcción de una tarea de fuente. Cuando está lista, devuelve URLs directas ttf/otf/woff/woff2 — descárgalas directamente, sin necesidad de autenticación.
| linkobligatorio | El enlace de la fuente devuelto por generate_font. |
Obtiene los bytes del archivo de fuente directamente como un recurso MCP, para que tu agente pueda escribirlo directamente en el disco de tu proyecto. Si el archivo es inusualmente grande, devuelve una URL normal en su lugar.
| linkobligatorio | El enlace de la fuente devuelto por generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Lista todos los códigos de idioma ISO-2 admitidos con el número de glifos y la dirección del texto — úsalo para construir un array languages válido.
Lista tus últimas 100 tareas de fuentes — estado, modelo, origen y un enlace a la página de cada fuente.
Las herramientas MCP son tan buenas como el prompt que hay detrás. Estos dan resultados sólidos de forma constante:
«Genera una fuente sans-serif amigable y redondeada para una app educativa infantil, en inglés y español, pesos normal y bold — luego guarda los archivos ttf en ./public/fonts.»
Especifica el tono, los idiomas, los pesos y dónde colocar el resultado — el agente puede ejecutar todo el ciclo sin supervisión.
«Aquí tienes una captura de nuestro antiguo logo: https://example.com/logo.png — genera una fuente de titulares que combine con su estilo, calidad ultra, solo en inglés.»
Las imágenes de referencia superan a los adjetivos a la hora de igualar un estilo existente concreto — model_tier: ultra vale la pena para tipos de titulares o hero.
«Revisa el estado de la fuente 8WeheWlTl y avísame cuando esté lista, luego dame la URL del woff2.»
Un simple consultar-e-informar — útil para revisar una tarea que iniciaste antes en la conversación.
«¿Qué idiomas cirílicos y griegos admite YoFont? Necesito una fuente que cubra ruso, ucraniano y griego.»
Deja que el agente llame a list_languages en lugar de adivinar los códigos ISO de memoria — evita que generate_font falle por un código mal escrito.
«Genera una fuente de titulares geométrica a partir de esta imagen de referencia, espera a que termine, luego descarga el ttf y añádelo a nuestra configuración de Tailwind como font-face personalizado.»
Encadena las tres herramientas en una sola instrucción — generar → consultar → descargar — y le da al agente un siguiente paso concreto.
«Muéstrame todas mis fuentes y dime cuáles siguen en cola o han fallado.»
Útil para revisar el estado de todo un proyecto sin abrir el panel.
Una sola petición tuya puede activar todo el proceso — tu agente se encarga del ciclo de consultas, tú solo ves el resultado.