v8

latestOpenAPI 3.1.1LicenseRef-Proprietaryraw.githubusercontent.com2026-05-19280916.6 KB

Runs

Start a top-level technique run

Starts a technique run through the normalized top-level run resource. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

post/runs/technique

Request body

technique_idstring required

Technique identifier

workspace_idstring required

Workspace identifier

inputsobject required

Technique inputs

Example request

{
  "technique_id": "tech_abcd1234",
  "workspace_id": "ws_abc123"
}

Response

Technique run started.

run_idstring required

Run identifier

type'generation' | 'technique' | 'action' required

Run type

estimated_secondsinteger nullable required

charged_costnumber required

Cost charged in USD

poll_urlstring uri nullable

project_idstring nullable

Project identifier

Example response

{
  "run_id": "run_abc123",
  "model": {
    "model_id": "t2i-flux-2-pro"
  },
  "technique": {
    "technique_id": "tech_abcd1234"
  },
  "action": {
    "action_id": "split-text"
  },
  "project_id": "prj_abc123"
}