Render API

How it works

Every request sends Authorization: Bearer YOUR_API_KEY. Upload a font once and reuse its id with any tool.

1. 01

   Upload the font

   Send the font file. You get back its id.

   POST /api/v1/font

   curl JavaScript Python PHP

   curl -X POST "https://font.rest/api/v1/font" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -F "[email protected]"

   const body = new FormData();
   body.append('font', fileInput.files[0]);
   
   const response = await fetch('https://font.rest/api/v1/font', {
     method: 'POST',
     headers: { Authorization: 'Bearer YOUR_API_KEY' },
     body,
   });
   const data = await response.json();

   import requests
   
   response = requests.post(
       'https://font.rest/api/v1/font',
       headers={'Authorization': 'Bearer YOUR_API_KEY'},
       files={'font': open('MyFont.ttf', 'rb')},
   )
   data = response.json()

   <?php
   
   use Illuminate\Support\Facades\Http;
   
   // withToken() sends the Authorization: Bearer header.
   $response = Http::withToken('YOUR_API_KEY')
       ->attach('font', file_get_contents('MyFont.ttf'), 'MyFont.ttf')
       ->post('https://font.rest/api/v1/font');
   $data = $response->json();

2. 02

   Render it

   Describe the canvas and the text layers.

   POST /api/v1/render

   curl JavaScript Python PHP

   curl -X POST "https://font.rest/api/v1/render" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"canvas":{"preset":"open-graph","background":{"type":"color","value":"#111827"}},"layers":[{"content":"Everything Fonts","font":{"id":"FONT_ID"},"style":{"size":120,"color":"#ffffff"},"box":{"x":80,"y":240,"width":1040,"height":160}}],"output":{"format":"png"}}'

   const response = await fetch('https://font.rest/api/v1/render', {
     method: 'POST',
     headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
     body: JSON.stringify({"canvas":{"preset":"open-graph","background":{"type":"color","value":"#111827"}},"layers":[{"content":"Everything Fonts","font":{"id":"FONT_ID"},"style":{"size":120,"color":"#ffffff"},"box":{"x":80,"y":240,"width":1040,"height":160}}],"output":{"format":"png"}}),
   });
   const data = await response.json();

   import requests
   
   response = requests.post(
       'https://font.rest/api/v1/render',
       headers={'Authorization': 'Bearer YOUR_API_KEY'},
       json={"canvas":{"preset":"open-graph","background":{"type":"color","value":"#111827"}},"layers":[{"content":"Everything Fonts","font":{"id":"FONT_ID"},"style":{"size":120,"color":"#ffffff"},"box":{"x":80,"y":240,"width":1040,"height":160}}],"output":{"format":"png"}},
   )
   data = response.json()

   <?php
   
   use Illuminate\Support\Facades\Http;
   
   // withToken() sends the Authorization: Bearer header.
   $response = Http::withToken('YOUR_API_KEY')
       ->post('https://font.rest/api/v1/render', array (
     'canvas' => 
     array (
       'preset' => 'open-graph',
       'background' => 
       array (
         'type' => 'color',
         'value' => '#111827',
       ),
     ),
     'layers' => 
     array (
       0 => 
       array (
         'content' => 'Everything Fonts',
         'font' => 
         array (
           'id' => 'FONT_ID',
         ),
         'style' => 
         array (
           'size' => 120,
           'color' => '#ffffff',
         ),
         'box' => 
         array (
           'x' => 80,
           'y' => 240,
           'width' => 1040,
           'height' => 160,
         ),
       ),
     ),
     'output' => 
     array (
       'format' => 'png',
     ),
   ));
   $data = $response->json();

What it can do

Plans

API access comes with the Premium and Enterprise plans. Every plan includes a monthly job allowance; a job that fails is not counted.