taskq.xyz / developers
Developer surface

Drop in like an API. Get proof like infrastructure.

TaskQ gives builders one gateway for AI requests, queue jobs, policy routing, BYOK credentials, and HashIQ proof headers. Two environment variables. No silent fallback. No mystery execution.

terminal — setup.sh
Endpoints

One public surface. Relay and queue underneath.

Developers should not have to learn the whole execution topology to ship. The Gateway owns auth, policy, placement, proof, and settlement. You choose synchronous API calls or longer-running jobs.

Relay — chat-shaped calls

Anthropic-shaped or OpenAI-shaped routes for synchronous completions, streaming, token count, and model listing.

Queue — agentic jobs

Submit longer-running work that produces artifacts, reports, patches, generated files, and terminal job states.

Proof — chain lookup

Fetch the signed receipt for any request or job using the returned request ID or chain key.

relay — messages · sync
POST /v1/messages
POST /v1/messages/count_tokens
GET  /v1/models
POST /v1/chat/completions

# response headers
x-taskq-request-id: req_8X3...
x-taskq-chain-key: hshq_184467
x-taskq-placement-proof: proof_4b7...
queue — jobs · async
POST /q/submit
GET  /q/thread/{job_id}
GET  /q/artifacts/{artifact_id}

# terminal states
queued → leased → running → succeeded
queued → policy_blocked
running → failed
succeeded → settlement_reconciled
Policy schema

Policy should be code, not a support ticket.

Developers can make execution requirements explicit. Hard constraints never silently relax. Empty compliant pools return a refusal with proof.

policy.json — hard constraints
{
  "provider": "anthropic",
  "plane": "relay",
  "must_run_in": ["CA"],
  "must_not_run_in": ["US"],
  "min_attestation_tier": "audited",
  "key_custody": ["pinned", "enclave"],
  "data_residency": "ephemeral",
  "max_price_usd_per_mtok": 0.75,
  "allow_queue_replacement": false
}
What developers get

Not another wrapper. A control plane you can build against.

SDK shape — drop-in surface

Anthropic-shaped, OpenAI-shaped, and TaskQ-native routes let teams adopt proof without rewriting every workflow.

Ops shape — policy defaults

Tenant defaults, sub-keys, per-request policies, rate gates, budgets, and proof exports.

Audit shape — receipts everywhere

Every execution, refusal, credential access, artifact, and settlement event can map to the chain.

Build with the gateway. Keep the proof.

Two env vars, familiar endpoints, policy-bound routing, queue jobs, and HashIQ receipts.