Maxwell Docs
Full documentation is coming soon. Here's the gist.
Call a completion
Authenticate with a Maxwell API key and reference the prompt by its public ID only — models and strategy are fixed by the prompt.
curl -X POST https://api.maxwell.dev/v1/completions \
-H "Authorization: Bearer mxk_..." \
-H "Content-Type: application/json" \
-d '{"prompt_id":"prmt...","variables":{"name":"Ada"}}'Async completions
If a prompt defines a callback URL, the endpoint returns 202 immediately and a worker POSTs the signed result to your callback URL (verify the X-Maxwell-Signature header).
Strategies
- Fallback — try models in order until one succeeds. Accepts a single input set, or a list of input sets to run as a batch.
- Broadcast — call all models in parallel; return all.
- Contest — contestants generate; an adjudicator picks the winner.
- Batch — a fallback prompt called with multiple input sets; each set runs as a fallback completion in parallel, optionally merged. It's the same engine as fallback, just with batched inputs.