RatioReady
REST API

Automate your image processing workflow

Process images programmatically with a simple REST API. Integrates with Make.com, n8n, and any HTTP client.

Full Processing Suite

Clipart, wall art, poster, mockup, upscale, and DPI conversion — single image or batch, all via REST.

URL or File Upload

Submit images by direct URL (ideal for automation) or multipart file upload.

Async Job Polling

Long-running jobs return a job ID. Poll for status, download results when ready.

API Key Auth

Simple Bearer token authentication. Generate your key from your dashboard profile.

Batch Processing

Process up to 25 images per batch. ZIP download, individual file access, and automatic retry for failed images.

Webhook-friendly

Designed for no-code automation tools. Standard JSON request/response format.

Quick example

Request

curl -X POST https://ratioready.com/v1/batch/wallart \
  -H "Authorization: Bearer pk_your_api_key" \
  -F "images=@artwork1.png" \
  -F "images=@artwork2.png" \
  -F 'payload={
    "tier": "studio",
    "printSize": 4096,
    "userSetId": "set_abc123",
    "listingPreview": true
  }'

Response

{
  "batchId": "batch-xyz-789",
  "status": "processing",
  "total": 2,
  "completed": 0,
  "failed": 0
}

// Poll GET /v1/batch/batch-xyz-789 →
{
  "status": "completed",
  "total": 2,
  "completed": 2,
  "downloadUrl": "/v1/batch/batch-xyz-789/download"
}

Endpoint reference

Method Endpoint Auth
POST /v1/clipart Bearer
POST /v1/wallart Bearer
POST /v1/poster Bearer
POST /v1/mockup Bearer
POST /v1/dpi Bearer
POST /v1/batch/clipart Bearer
POST /v1/batch/wallart Bearer
POST /v1/batch/poster Bearer
POST /v1/batch/upscale Bearer
POST /v1/batch/:id/retry Bearer
GET /v1/job/:id Bearer
GET /v1/batch/:id Bearer
GET /v1/batch/:id/download Bearer
GET /v1/batch/:id/files/print/:index Bearer
GET /v1/batch/:id/files/preview/:index Bearer
GET /v1/me Bearer
GET /v1/pricing/costs Public
GET /v1/pricing/packs Public

Works with your tools

Make.com

Use the HTTP module to call any endpoint. Submit images by URL, poll for results, and route outputs to your next automation step.

n8n

Build workflows with the HTTP Request node. Chain image processing with listing creation on Etsy, Amazon, or Shopify.

Any HTTP client

Standard REST API with JSON responses. Works with curl, Python requests, Node.js fetch, or any language and framework.

Authentication

  1. 1 Create an account at ratioready.com/register
  2. 2 Go to your Profile page and generate an API key (starts with pk_)
  3. 3 Include it as a Bearer token: Authorization: Bearer pk_your_key

API FAQ