Skip to main content
POST
/
v1
/
font-generations
/
image
Create an image font generation
const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    image_url: 'https://images.example.com/reference-wordmark.png',
    glyph_set: 'standard'
  })
};

fetch('https://api.mixfont.com/v1/font-generations/image', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "a4d94d83-4134-4d43-b801-e4077e4a2816",
  "name": "Reference Sans",
  "ttf_url": null,
  "status": "preparing",
  "input_type": "image",
  "glyph_set": "standard",
  "progress_percent": 0,
  "poll_url": "https://api.mixfont.com/v1/font-generations/a4d94d83-4134-4d43-b801-e4077e4a2816",
  "created_at": "2026-06-02T21:15:10.000Z"
}
Start a font generation job from a public reference image URL. The response returns immediately with an id and poll_url. Reference image URLs must use HTTPS, be publicly reachable, point to a JPEG, PNG, or WebP image, and be no larger than 20 MB.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
image_url
string<uri>
required

Public HTTPS URL for a JPEG, PNG, or WebP reference image. The image must be publicly reachable and no larger than 20 MB.

Maximum string length: 2000
​
glyph_set
enum<string>
default:standard

standard generates 72 glyphs to support English with basic letters, numbers, and punctuation. extended generates 319 glyphs to support all Latin languages, including special characters, costs more credits, and may take 2-3 minutes to complete.

Available options:
standard,
extended

Response

Generation job accepted

​
id
string
required

Generation id.

​
name
string
required

Generated font display name.

​
ttf_url
string<uri> | null
required

Download URL for the generated TTF file. This is null until the job succeeds.

​
status
enum<string>
required
Available options:
preparing,
queued,
running,
succeeded,
cancelled,
failed
​
input_type
enum<string>
required
Available options:
text,
image
​
glyph_set
enum<string>
default:standard
required

standard generates 72 glyphs to support English with basic letters, numbers, and punctuation. extended generates 319 glyphs to support all Latin languages, including special characters, costs more credits, and may take 2-3 minutes to complete.

Available options:
standard,
extended
​
progress_percent
number
required

Approximate job progress percentage.

Required range: 0 <= x <= 100
​
poll_url
string<uri>
required

URL to poll for generation status.

​
created_at
string<date-time>
required

ISO timestamp for when the generation was created.

​
error
string

Error message. Present only when status is failed and an error message is available.