History: Concepts

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

16 Oct 2026 · +18 −0 lines

Show changes

⋯
  A run carries its `price` and a `charge`: `held` while it runs, `charged` when it completes, `released` when it is free, `none` for test keys. Cancel a queued run with `POST` to its `cancel_url`; the hold is released.
  
+ ### Rate a result {#rate-a-result}
+ 
+ **Rolling out, optional.** Tell Wandura whether a result was good:
+ 
+ ```bash
+ curl -X POST https://api.wandura.ai/v2/runs/run_Qk2m9XaB7Lc4/feedback \
+   -H "Authorization: Bearer $WANDURA_KEY" -H "Content-Type: application/json" \
+   -d '{"rating": "down", "reason": "Face does not match"}'
+ ```
+ 
+ - `rating`: `up` or `down`. `reason`: optional, at most 280 characters.
+ - The id is a run's `id` or a job's `job_id`, made with a key of the same product.
+ - One rating per run per API key. Calling again replaces it.
+ - The answer is the stored rating: `object` `run_feedback`, `run`, `rating`, `reason`, `created_at`, `updated_at`.
+ - Errors: `400 invalid_request` (bad `rating` or `reason`), `404 run_not_found`.
+ 
+ Wandura reads the ratings to improve styles. They are not shown publicly, and nothing else depends on them. In the console, Runs and the Playground have the same thumbs up and down.
+ 
  ## Styles and lanes {#styles-and-lanes}
  
⋯

16 Oct 2026 · +2 −0 lines

Show changes

⋯
  > **TL;DR** — A run is one call to one style. Priority is on time or free; Relax waits in line with no deadline and is never priced above Priority. A run that did not deliver is free. Webhooks are signed; submits are idempotent; `end_user_id` is required.
  
+ These concepts hold for both doors. New integrations start with the [Jobs API](jobs.md), which uses the job words (`processing`, `succeeded`, `cancelled`, `timeout`); this page also describes runs, which stay supported.
+ 
  ## Runs {#runs}
  
⋯

16 Oct 2026 · +15 −0 lines

Show changes

⋯
  No storage of your own? `POST /v2/uploads` with `{content_type, size_bytes}` returns a presigned `upload_url`. PUT the bytes there, then pass `file_url` in `inputs`. Files are kept 24–48 hours.
  
+ ## API keys {#api-keys}
+ 
+ > **Rolling out:** the permission, allowed styles and tags below reach api.wandura.ai and the console with the next release.
+ 
+ A key belongs to one product. When you create one in the console under **Keys**, you can narrow it to one app or one person:
+ 
+ | Setting | What it does | When a call is refused |
+ |---|---|---|
+ | **Permission** | **Run styles** (default): submit runs and jobs, read runs and styles. **Read only**: read runs and styles. | A Read only key that submits, cancels, shares or uploads gets `403 insufficient_scope` (Jobs API: `403 FORBIDDEN`). Nothing is created or charged. |
+ | **Allowed styles** | The styles this key may run. Leave it empty for every style your org can run. | Any other style gets `403 style_not_allowed` on runs and quotes (Jobs API: `403 FORBIDDEN`). |
+ | **Tags** | Labels for your own sorting, for example `android` or a teammate's name. | Never: tags change nothing. |
+ | **Expires** | 1 day to 1 year, or never. The list shows **Expires soon** from 7 days before. | After it: `401 api_key_expired`. |
+ 
+ If your org can run only some styles, a key's allowed styles stay inside that set. A key made without these settings works as keys always have and never gets a `403`. Rotating a key keeps its settings; to change them, create a new key and revoke the old one. The key object and the `key.expiring` / `key.revoked` webhooks show `preset` (`run_styles` or `read_only`), `allowed_styles` and `tags` only on keys that have them.
+ 
  ## Test and live {#test-and-live}
  
⋯

16 Oct 2026 · +6 −0 lines

Show changes

⋯
  Need more? Tell us your volume and we raise your org's limits.
  
+ ### Runs at once by spend {#spend-tiers}
+ 
+ > **Rolling out:** spend tiers are built but not switched on yet. Until they are, every account has the default above.
+ 
+ Once they are on, a product on the default limit gets more runs at once as your org adds money by card. What counts is card top-ups credited in the last 28 days, minus refunds. The limit only goes up: no tier is below the default, and a limit we set for your product by agreement stays as set. The current tier table is on [open.wandura.ai/pricing](https://open.wandura.ai/pricing). Your tier, what you added and what the next tier needs show in `GET /v2/queue` (field `spend_tier`) and on the console's Limits page.
+ 
  ## Idempotency {#idempotency}
  
⋯

16 Oct 2026 · +2 −2 lines

Show changes

  # Concepts
  
- > **TL;DR** — A run is one call to one style. Priority is on time or free; Relax is cheaper and waits. A run that did not deliver is free. Webhooks are signed; submits are idempotent; `end_user_id` is required.
+ > **TL;DR** — A run is one call to one style. Priority is on time or free; Relax waits in line with no deadline and is never priced above Priority. A run that did not deliver is free. Webhooks are signed; submits are idempotent; `end_user_id` is required.
  
  ## Runs {#runs}
⋯
  
  - **Priority**: done within the style's promise (shown in the [styles reference](styles.md)) or the run is free.
- - **Relax**: cheaper, waits in line, one active run per end user.
+ - **Relax**: waits in line with no deadline, one active run per end user; never priced above Priority.
  
  `POST /v2/quote` takes the same body as a run and returns the price and ETA without charging.
⋯

15 Oct 2026 · +3 −1 lines

Show changes

⋯
  Event types: `run.running`, `run.completed`, `run.failed`, `run.nsfw`, `run.canceled`. Output links are kept 72 h.
  
+ Your product can also opt in to congestion events, `queue.congestion_started` and `queue.congestion_ended`: see [Queue and congestion](queue-and-congestion.md#events).
+ 
  ## Limits {#limits}
  
⋯
  |---|---|---|
  | Runs per end user per day | 20 | Over it: 429 `end_user_cap_reached` with `Retry-After` (resets 00:00 UTC). Your org can change its cap. |
- | Runs at once per product | 20 | More runs wait in line (queued) instead of failing; Priority goes first. |
+ | Runs at once per product | 20 | More runs wait in line (queued); Priority goes first. As many priority runs can wait as you have slots; past that, a new priority run gets 429 `product_busy` with `Retry-After`. Submit answers show the numbers: see [Queue and congestion](queue-and-congestion.md). |
  | Active Relax runs per end user | 1 | The next Relax run of that end user starts when the last one ends. |
  | Webhook signature window | 300 s | Reject a webhook whose timestamp is older or newer than this. |
⋯

14 Oct 2026 · Page created