API

Access key

Create a key in your account and pass it as a header. The key is shown once at creation — save it right away.

Authorization: Bearer sk_ваш_ключ

In a minute

1. Upload the file. The request body is the file itself, no multipart. The type is detected from content, not from the extension.

curl -X POST "https://formatika.app/api/v1/uploads?toolId=image.convert&filename=photo.png" \
  -H "Authorization: Bearer $FORMATIKA_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @photo.png

# {"id":"up_…","filename":"photo.png","mime":"image/png","bytes":820428}

2. Create a job. Parameters are validated against the schema of the tool you named.

curl -X POST "https://formatika.app/api/v1/jobs" \
  -H "Authorization: Bearer $FORMATIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "toolId": "image.convert",
    "uploadIds": ["up_…"],
    "params": { "format": "webp", "quality": 82 }
  }'

# {"id":"job_…","status":"QUEUED","toolId":"image.convert","credits":0}

3. Poll the status once a second. When it turns DONE, files carries the result links — signed and valid for 15 minutes.

curl "https://formatika.app/api/v1/jobs/job_…" -H "Authorization: Bearer $FORMATIKA_KEY"

# {"status":"DONE","progress":100,
#  "files":[{"filename":"photo.webp","bytes":9352,"url":"/api/v1/files/…?exp=…&sig=…"}]}

curl -O -J "https://formatika.app/api/v1/files/…?exp=…&sig=…"

Allowances and credits

Free: 10 jobs a day without an account, 50 with one. Beyond that a job costs credits; signing up grants 50. The credits field of the response says what was charged.

Tools

Errors

You get a code, not a message: you compose the text yourself, in your own language. The HTTP status matches the code.