Endpoints
The service exposes a single versioned contract under /v1. All /v1 routes require a bearer key (Authorization: Bearer gi_…); the documentation and health routes are public.
note
ReDoc is the complete reference. This page is an orientation map. For exact request and response schemas, every field, and per-operation examples, use ReDoc or the OpenAPI schema.
Routes
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/tasks/{task}/predict | Run a prediction task. Synchronous by default; opt into async with the Prefer: respond-async header to receive a 202 and a job ID. |
| GET | /v1/tasks/jobs/{job_id} | Poll an async job. Returns 202 while running, 200 with the result on success, and a 4xx/5xx on terminal failure. |
| GET | /v1/tasks/jobs | List your recent jobs. Owner-scoped: other callers receive 404 for job IDs they do not own. |
| GET | /v1/tasks/{task}/models | List the models registered for a task and the default model. |
| GET | /health | Liveness probe. Public. Returns {status, version}. |
Tasks
The {task} path parameter accepts one of six values:
promoter, splice, enhancer, chromatin, expression, annotation
Per-task sequence-length caps and async opt-in thresholds are documented on the Limits page.
Reference
- ReDoc — browsable contract.
- OpenAPI JSON — machine-readable schema (OpenAPI 3.1) for client codegen.
Both routes are public, along with /docs.