Get a job

Fetch a job’s status and result. Supports long-polling via ?wait, the endpoint to call after creating a job.

Request

Authorization

string

required

Bearer sk_live_...

string

required

The job id returned by POST /v1/text, POST /v1/audio, or POST /v1/image.

wait

number

Seconds to long-poll, 0–30. The server holds the response until the job reaches completed or failed, or the timeout passes, then returns the current job either way. A typical flow is 1–2 calls instead of a polling loop, and since rate limits count per request, wait also saves quota.

Response

string

Job id.

status

string

created, pending, processing, completed, or failed. See Jobs.

error

string

Failure reason. Only present on failed jobs.

result

object

Present once the job completes.

Show properties

outputUrl

string

Signed download URL for file outputs. Freshly generated on every read, valid for 1 hour; re-fetch the job for a new one. Audio outputs are .ogg (Opus) by default or .mp3 if requested via encode; image outputs are .webp, .avif, .jpg, or .png; file-based text outputs are .txt.

outputText

string

Inline output for text jobs created from inline text.

metrics

object

inputSize, outputSize, compressionRatio, operationsApplied.

Results remain available for 7 days after completion.

Examples

Long-poll (recommended)

curl -s "https://api.robinzip.app/v1/jobs/665f1d00b8d4e91a2c3d4e60?wait=25" \
  -H "Authorization: Bearer $ROBIN_KEY"

Instant read

curl -s https://api.robinzip.app/v1/jobs/665f1d00b8d4e91a2c3d4e60 \
  -H "Authorization: Bearer $ROBIN_KEY"

{
  "success": true,
  "data": {
    "id": "665f1d00b8d4e91a2c3d4e60",
    "status": "completed",
    "result": {
      "outputUrl": "https://...signed-get-url...",
      "metrics": {
        "inputSize": 52428800,
        "outputSize": 6291456,
        "compressionRatio": 8.33,
        "operationsApplied": ["trim-silence", "normalize", "compress", "encode"]
      }
    }
  }
}

{
  "success": true,
  "data": {
    "id": "665f1d00b8d4e91a2c3d4e60",
    "status": "processing"
  }
}

{
  "success": true,
  "data": {
    "id": "665f1d00b8d4e91a2c3d4e60",
    "status": "failed",
    "error": "Empty response from S3"
  }
}

Errors

Code	HTTP	When
`JOB_NOT_FOUND`	404	Unknown id, malformed id, or job owned by another account

Getting Started

Core Concepts

API Reference

Request

Response

Examples

Errors

​Request

​Response

​Examples

​Errors

Request

Response

Examples

Errors