API reference
Plain HTTP, if you are not in TypeScript. The SDK is a wrapper over exactly this.
Authentication
A bearer token on every request that spends money or reads your data. Reading the catalogue needs nothing.
bash
authorization: Bearer sk_sequel_…Without one you get 401 and a WWW-Authenticate header. MCP clients can use OAuth instead; see MCP tools.
Endpoints
MethodPathWhat it does
GET/api/modelsCatalogue. ?q= and ?type= to search. Open
GET/api/models/:id/schemaA model's input schema. Open
POST/api/tasksRun a model
GET/api/tasksList runs, scoped to your organisation
GET/api/tasks/:idOne run
POST/api/uploadGet an upload URL
GET/api/usageSpend summary
GET/api/webhooksRegistered endpoints
Model ids contain slashes, so encode them: /api/models/%40cf%2Fblack-forest-labs%2Fflux-1-schnell/schema.
Running a model
bash
curl -X POST https://api.sequel.sh/api/tasks \ -H "authorization: Bearer sk_sequel_…" \ -H "content-type: application/json" \ -d '{ "model": "black-forest-labs/flux-1-schnell", "input": { "prompt": "a ceramic mug on seamless white" } }'
Note input rather than params — the SDK renames it, the wire does not.
json
{ "task_id": "task_1d212b8a6ca24206b2e7", "status": "completed", "result_url": "https://…/f/VC6mrteqQL", "assets": [{ "url": "https://…/f/VC6mrteqQL", "mime": "image/jpeg", "bytes": 170542 }], "cost": { "usd": "0.000634", "estimated": true, "basis": "4 tile(s) @ $0.000053" } }
Errors
StatusMeansNotes
400Bad inputUnknown parameter names are refused, with the valid ones listed
401No usable credentialWWW-Authenticate names the scheme
404No such model or task
429Upstream rate limitRetry with backoff