Sign in

v8

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

Start an action run

Starts a headless prebuilt action run using raw action slugs such as rotate-image. Direct action runs do not create or mutate canvas nodes. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

post/runs/action

Request body

action_id'split-text' | 'find-and-replace-text' | 'concat-text' | 'ken-burns-video' | 'color-grade-image' | 'change-image-ar' | 'rotate-image' | 'flip-image' | 'color-filter-image' | 'color-tint-image' | 'filter-color-image' | 'blur-image' | 'duplicate-image' | 'side-by-side-composite' | 'add-shape-to-image' | 'generate-shape-image' | 'add-text-to-image' | 'generate-text-image' | 'qr-code-generator' | 'stitch-videos' | 'split-video' | 'extract-video-frames' | 'color-grade-video' | 'video-to-frame-grid' | 'boomerang-video' | 'reverse-video' | 'video-to-long-exposure' | 'video-effect' | 'color-filter-video' | 'speed-up-video' | 'slow-down-video' | 'duplicate-video' | 'greenscreen-video' | 'resize-video' | 'change-video-ar' | 'split-audio-from-video' | 'merge-audio-into-video' required

Action identifier. Use raw action slugs, not action-prefixed IDs.

workspace_idstring required

Workspace identifier

project_idstring required

Project identifier used for ownership, billing, and run history. Direct action runs do not mutate the project canvas.

paramsobject

Action parameters

Example request

{
  "action_id": "split-text",
  "workspace_id": "ws_abc123",
  "project_id": "prj_abc123"
}

Response

Action 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"
}