Genjutsu

Endpoints

Community genjutsu are exposed through a dedicated set of endpoints. Every request must include Authorization: Bearer bd_YOUR_API_KEY. Replace {WORKFLOW_ID} and {RUN_ID} with the values returned by the list and execute calls.

List genjutsu

Returns approved genjutsu from approved creators, newest first. Supports limit (1–50) and final_output_type (image | video | audio).

curl "https://bumi.digital/api/v1/workflows?limit=20&final_output_type=video" \
  -H "Authorization: Bearer bd_YOUR_API_KEY"

Get a genjutsu

Use this call to read the input schema of a single genjutsu. Each public input node exposes a config.input.key — that key is the property name you send inside input when executing the genjutsu.

Execute payload

Execution is asynchronous. Send an input object whose properties are the public input keys of the genjutsu, plus a unique Idempotency-Key (header or idempotency_key body property). Active execution returns HTTP 202 with a workflow_run and a status_url.

{
  "input": {
    "<input-key>": "value or https:// URL for image/video inputs"
  },
  "idempotency_key": "unique-string"
}

Text inputs take a plain string. Image and video inputs take a public HTTP(S) URL — upload the file first (see Upload Files) and pass the returned URL. Reusing the same key with the same input does not create another run; changing the input with the same key returns 409. The creator-test: prefix is reserved.

Poll run status

Poll GET /api/v1/workflow-runs/{RUN_ID} until the current stage finishes, then call POST /api/v1/workflow-runs/{RUN_ID}/continue to start the next stage. Repeat until the run is COMPLETED or FAILED. Only runs created with your own API key can be retrieved.

{
  "workflow_run": {
    "id": "cwrun_xxxxxxxxxxxx",
    "workflow_id": "cmxxxxxxxxxxxxxx",
    "status": "RUNNING",
    "output": {
      "image-1": {
        "generation_id": "cmlvxxxxx",
        "status": "processing",
        "output_url": null,
        "text": null
      }
    },
    "debited_credits": 0,
    "started_at": "2026-01-01T00:00:00.000Z",
    "finished_at": null,
    "error": null
  },
  "status_url": "/api/v1/workflow-runs/cwrun_xxxxxxxxxxxx"
}

Available genjutsu

Expand a genjutsu to see its input JSON Schema, a ready-to-run payload, the matching cURL request, and the response format. Credits shown are estimates — the final charge is computed when the run executes.