Blaize File Converter

API Docs

Use the Blaize API to upload files, convert them, poll progress, and download outputs.

Quick start

  1. Sign in and open Account.
  2. Generate API key and confirm with 6 digit email code.
  3. Copy key now and store it securely. It is shown once.
  4. Use key with Authorization Bearer header.

Base URL

https://converter.blaizestudios.com

Auth header

Authorization: Bearer blaize_live_xxx

Endpoints

POST /api/v1/upload

POST /api/v1/convert

GET /api/v1/convert/status?jobId=...

GET /api/v1/convert/progress?jobId=...

GET /api/v1/download?token=...

GET /api/v1/usage

Node example

const fd = new FormData();
fd.append("file", new File([buffer], "convert.png"));

const upload = await fetch("https://converter.blaizestudios.com/api/v1/upload", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.API_KEY },
  body: fd,
}).then((r) => r.json());

const start = await fetch("https://converter.blaizestudios.com/api/v1/convert", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ uploadId: upload.uploadId, targetId: "jpeg" }),
}).then((r) => r.json());

Python example

import requests
API_KEY = "your_key"
BASE = "https://converter.blaizestudios.com"
headers = {"Authorization": f"Bearer {API_KEY}"}

with open("convert.png", "rb") as f:
    up = requests.post(f"{BASE}/api/v1/upload", headers=headers, files={"file": ("convert.png", f, "image/png")}).json()

job = requests.post(
    f"{BASE}/api/v1/convert",
    headers={**headers, "Content-Type": "application/json"},
    json={"uploadId": up["uploadId"], "targetId": "jpeg"},
).json()

status = requests.get(f"{BASE}/api/v1/convert/status", headers=headers, params={"jobId": job["jobId"]}).json()

cURL example

curl -X POST "https://converter.blaizestudios.com/api/v1/upload" \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "file=@convert.png"

curl -X POST "https://converter.blaizestudios.com/api/v1/convert" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"uploadId\":\"UPLOAD_ID\",\"targetId\":\"jpeg\"}"

PHP example

<?php
$key = "YOUR_KEY";
$base = "https://converter.blaizestudios.com";
$ch = curl_init("$base/api/v1/usage");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $key"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$body = curl_exec($ch);
curl_close($ch);
echo $body;

C# example

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
  new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR_KEY");
var usage = await http.GetStringAsync("https://converter.blaizestudios.com/api/v1/usage");
Console.WriteLine(usage);

Profile and utility tools

Image profile tools

  • sRGB profile fix
  • Metadata strip option
  • Resize presets

Document utility actions

  • Split PDF
  • Merge PDF
  • Compress PDF

Limits

  • Premium Lite API quota: 200 conversions per UTC day.
  • Premium API quota: 2500 conversions per UTC day.
  • Free plan API is disabled.