Gere fontes, busque glifos e gerencie a entrega por código. O mesmo motor do app, a um bearer token de distância.
Todas as requisições usam um bearer token no cabeçalho Authorization. Guarde-o no servidor.
Entre para gerar uma chave de API ativa — o acesso à API e ao MCP está incluído nos planos Pro e Studio.
Entre para pegar sua chaveAs requisições são limitadas por chave de API. Ultrapassar o limite devolve 429 Too Many Requests com um Retry-After. Os limites acompanham o seu plano:
| Criar fonte · todo o resto | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Precisa de mais vazão? Faça upgrade do plano.
Gera uma família de fontes completa a partir de um prompt de texto e/ou de uma imagem de referência. Devolve um job que você consulta até concluir.
| promptobrigatório | Descrição da tipografia em linguagem simples. Optional when reference_image_url is set. |
| reference_image_url | Imagem de referência de estilo (PNG/JPG/WEBP) — uma URL pública direta. Nunca a armazenamos; repassamos o link como está para o motor de renderização, igual ao recurso de captura-para-fonte dos plugins do Figma e do Chrome. |
| languages | Array de códigos ISO — o padrão é ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | p. ex. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Busca o status de uma fonte e as URLs de download (TTF / WOFF2 / variável).
Baixa o arquivo de fonte montado num formato específico (ttf/otf/woff/woff2) — o mesmo arquivo que o botão de download do Studio produz.
Todos os códigos de idioma ISO-2 suportados, com a contagem de glifos por escrita e a direção do texto — use para montar um array "languages" válido.
Seus últimos 100 jobs de fonte — status, modelo, origem e um link para a página de cada fonte.
A geração é assíncrona. Depois do POST em generate, consulte GET /api/public/status?link=… a cada poucos segundos até o status ser font_ready (ou failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — quantos atlas de glifos estão prontos |
| fonts | URLs dos arquivos ttf/otf/woff/woff2, presentes assim que status = font_ready. Essas URLs exigem a sua chave de API — buscá-las sem o cabeçalho Authorization devolve 403. Baixe os bytes através de GET /api/public/download?link=…&format=…. |
Uma consulta a cada 3–5 segundos já basta — uma família completa costuma ficar pronta em menos de dois minutos. Busque os arquivos por GET /api/public/download com a sua chave de API; as URLs em "fonts" não são públicas.
Todos os erros seguem o mesmo formato JSON: { "success": false, "error": "…" }.
| 400 | Requisição inválida — campos ausentes ou inválidos. Confira o error para os detalhes. |
| 401 | Não autorizado — ausente ou inválido Authorization cabeçalho. |
| 402 | Pagamento necessário — cota de glifos esgotada. Recarregue na página de Planos. |
| 403 | Proibido — o link pertence a outra conta. |
| 404 | Não encontrado — o ID da fonte não existe ou pertence a outra conta. |
| 429 | Requisições demais — limite de requisições atingido. Tente de novo depois de Retry-After. |
| 500 | Erro interno — algo deu errado do nosso lado. Tentar de novo depois de alguns segundos costuma resolver. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
O MCP (Model Context Protocol) permite que agentes de IA de programação — Claude Code, Cursor, Codex e outros — chamem a YoFont direto enquanto trabalham: gerar uma fonte no meio da conversa, esperar a montagem e colocar o arquivo direto no seu projeto. Sem copiar e colar comandos curl.
Cada chamada de ferramenta MCP é um invólucro fino e transparente sobre os mesmos endpoints REST documentados na aba API — mesma autenticação, mesmos limites, mesma validação. Nada do que o servidor MCP faz está escondido da documentação REST.
Copie o prompt abaixo e cole no Claude Code, no Cursor ou no Codex. Seu agente registra sozinho o servidor MCP da YoFont e verifica a conexão — sem arquivos de configuração para editar à mão.
Pegue sua chave na seção Autenticação da aba API.
Aponte seu cliente MCP para https://yofont.com/api/public/mcp. Ele fala o transporte Streamable HTTP (modo de resposta JSON) — uma requisição JSON-RPC 2.0 por chamada, sem sessão ou socket aberto.
| Transporte | Streamable HTTP (JSON-RPC 2.0 por POST). Métodos: initialize, ping, tools/list, tools/call. |
| Autenticação | A mesma chave de API da REST — envie como cabeçalho em toda requisição: Authorization: Bearer yf_live_.... |
Cinco ferramentas, uma para cada endpoint REST da aba API — nada existe no MCP que não seja também REST puro.
Gera uma família de fontes nova a partir de um prompt e/ou de uma imagem de referência. Devolve na hora um link para consultar — é um job assíncrono, não uma chamada bloqueante.
| prompt | Descrição de estilo em linguagem simples. Opcional se reference_image_url for informado. |
| reference_image_url | URL pública direta da imagem — basta que ela possa ser baixada publicamente no momento da chamada. |
| languages, weights, glyph_types, model_tier | Mesmo formato e mesmos padrões do endpoint REST — veja a seção «Criar fonte» da aba API. |
Consulta o progresso da montagem de um job de fonte. Quando fica pronta, devolve as URLs dos arquivos ttf/otf/woff/woff2. Atenção: elas não são públicas (403) — use a ferramenta download_font para obter os bytes.
| linkobrigatório | O link da fonte devolvido por generate_font. |
Traz os bytes do arquivo de fonte embutidos como um recurso MCP, para que o seu agente escreva direto no disco do projeto. Cai para uma URL simples se o arquivo for grande demais.
| linkobrigatório | O link da fonte devolvido por generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Lista todos os códigos de idioma ISO-2 suportados com a contagem de glifos e a direção do texto — use para montar um array languages válido.
Lista seus últimos 100 jobs de fonte — status, modelo, origem e um link para a página de cada fonte.
As ferramentas MCP só são tão boas quanto o prompt por trás delas. Estes dão resultados consistentemente fortes:
«Gere uma sans-serif redonda e acolhedora para um app infantil de educação, em inglês e espanhol, nos pesos normal e bold — depois salve os arquivos ttf em ./public/fonts.»
Diz o clima, os idiomas, os pesos e onde colocar o resultado — o agente roda o ciclo inteiro sozinho.
«Aqui está uma captura do nosso logo antigo: https://example.com/logo.png — gere uma fonte display que combine com esse estilo, qualidade ultra, só em inglês.»
Imagens de referência batem adjetivos na hora de reproduzir um visual já existente — model_tier: ultra compensa em tipos de destaque e display.
«Verifique o status da fonte 8WeheWlTl e me avise quando estiver pronta; depois me passe a URL do woff2.»
Um consulta-e-avisa simples — bom para checar um job que você começou antes na conversa.
«Quais idiomas cirílicos e gregos a YoFont suporta? Preciso de uma fonte cobrindo russo, ucraniano e grego.»
Deixe o agente chamar list_languages em vez de adivinhar códigos ISO de memória — evita uma chamada generate_font falha por causa de um código errado.
«Gere uma fonte display geométrica a partir desta imagem de referência, espere terminar, baixe o ttf e adicione-o à nossa configuração do Tailwind como um font-face personalizado.»
Encadeia as três ferramentas numa instrução só — gerar → consultar → baixar — e entrega ao agente um próximo passo concreto.
«Mostre todas as minhas fontes e diga quais ainda estão na fila ou falharam.»
Bom para uma varredura de status do projeto inteiro sem abrir o painel.
Um pedido seu pode disparar o pipeline inteiro — seu agente cuida do ciclo de consultas e você só vê o resultado.