History: Wandura API v2

Every change to this page, newest first. Expand an entry to see what changed.

← Wandura API v2

1. 16 Oct 2026 · +9 −4 lines
   Show changes

   ⋯
     ## Two ways to call the same engine {#two-shapes}
     
   - | | Runs | Jobs |
   + **Start with jobs.** New integrations use the [Jobs API](jobs.md): one door, one set of words for statuses and errors. Runs stay supported and run on the same engine; nothing you built on them changes.
   + 
   + | | Jobs (recommended) | Runs |
     |---|---|---|
   - | Submit | `POST /v2/styles/{style}` | `POST /v2/jobs` |
   - | Result | A **run**: `status_url`, `cancel_url` | A **job**: `job_id`, `GET /v2/jobs/{job_id}` |
   - | Best for | Apps that call Wandura directly | Workflow engines that treat Wandura as a model provider |
   + | Submit | `POST /v2/jobs` | `POST /v2/styles/{style}` |
   + | Result | A **job**: `job_id`, `GET /v2/jobs/{job_id}`, signed `webhook_url` | A **run**: `status_url`, `cancel_url` |
   + | Statuses | `queued`, `processing`, `succeeded`, `failed`, `cancelled`, `timeout` | The same words in `state` (`status` keeps the older words) |
   + | Best for | Every new integration: apps, backends, workflow engines | Integrations already built on runs |
     | Same underneath | Keys, wallet, prices, fallback, and no charge for a run that did not deliver | |
     
   + **Rolling out:** the Relax lane (`lane`) and a style's own inputs (`inputs`) on `POST /v2/jobs`, so every style a key can run through runs also runs as a job (see [Jobs API](jobs.md#lane-and-inputs)).
   + 
     ## Reference {#reference}
     
   ⋯

2. 14 Oct 2026 · Page created