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