Meridias

Submit a production request

Routes a production request to the best provider via weighted scoring with automatic failover. The request references an uploaded S3 object key (see the uploads endpoint); document bytes are never inlined.

POST/v1/categories/{category_id}/process

Authorization

apiKeyAuth
X-API-Key<token>

In: header

Path Parameters

category_id*Category Id

Header Parameters

Idempotency-Key?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A production processing request for a category.

input is the category's uniform input. Document/blob fields must reference an uploaded object by its s3:// URI (returned as s3_uri by POST .../uploads) rather than inlining bytes — the platform resolves the object server-side. Non-document fields (e.g. mime_type, language_hints) are passed through as-is.

Example (OCR)::

{"input": {"document": "s3://meridias-public-uploads/uploads/...",           "mime_type": "image/png"}}

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/categories/497f6eca-6276-4993-bfeb-53cbbbba6f08/process" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {},  "meta": {    "estimated_cost": 0,    "failover_depth": 0,    "latency_ms": 0,    "trace_id": "string"  }}
{  "detail": [    {      "ctx": {},      "input": null,      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}