MANIFESTRO DOCS
Console
API Reference

Create a job

Queues a recording for processing and returns the job.

POST/v1/jobs

Send JSON. Name the recording with file_id (a file uploaded through POST /v1/files) or pass a public url. Exactly one of the two is required.

The API measures the duration, prices the job and reserves that amount on the balance. If the balance or a monthly limit does not cover it, the job is refused at once with 402.

Parameters

modelstringrequired
Model version, for example kezek-1.
file_idstring
ID of an uploaded file. Required unless url is set.
urlstring
Public https link to the recording. Required unless file_id is set.
cleanupstring
none (default), clean or studio.
output_formatstring
wav (default), flac or mp3.
outputstring
mono_pair (default) or stereo.
sample_rateinteger
16000, 24000, 44100 or 48000. Defaults to the input rate.

Errors

CodeStatusMeaning
unsupported_format400The file is not a supported audio format.
file_too_long400The recording is longer than 4 hours.
insufficient_balance402The balance does not cover the job.
monthly_limit_exceeded402The organization's or the key's monthly limit is reached.
model_not_allowed403The key is not allowed to use this model.
invalid_api_key401The key is missing, revoked or expired.
rate_limited429Too many requests. Retry after the Retry-After header.
Request
# 1. Register the file: the answer has its id and a pre-signed upload URL
curl https://api.manifestro.io/v1/files \
  -H "Authorization: Bearer $MANIFESTRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "conversation.wav"}'

# 2. Upload the bytes to upload.url with the headers from upload.headers
curl -X PUT "$UPLOAD_URL" -H "Content-Type: $CONTENT_TYPE" --data-binary @conversation.wav

# 3. Create the job
curl https://api.manifestro.io/v1/jobs \
  -H "Authorization: Bearer $MANIFESTRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "kezek-1", "file_id": "$FILE_ID", "cleanup": "clean", "output_format": "wav", "output": "mono_pair", "sample_rate": 48000}'

# 4. Poll until status is "completed", then download result.tracks[].url
curl https://api.manifestro.io/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer $MANIFESTRO_API_KEY"
Response · 201
{
  "id": "job_8f3k2m9x1q7w5e4r2t",
  "object": "job",
  "model": "kezek-1",
  "status": "queued",
  "created_at": "2026-11-16T09:12:44Z",
  "audio_seconds": 1834,
  "processing_seconds": 14,
  "cost": 0.4585,
  "params": {
    "cleanup": "clean",
    "output_format": "wav",
    "output": "mono_pair",
    "sample_rate": 48000
  }
}