run_model
Destructive
Run a hosted RunComfy model on demand without deployment. Submit model ID and inputs, optionally wait for completion to get results inline.
Instructions
Run a hosted RunComfy model on demand — no deployment needed.
Backs ``POST /v1/models/{model_id}`` on the Model API. Returns a
``request_id`` immediately; poll with ``get_model_request_status``
and fetch outputs with ``get_model_request_result``.
Args:
model_id: The model's identifier exactly as shown on its page at
runcomfy.com/models, e.g.
``blackforestlabs/flux-1-kontext/pro/edit``. Slashes are part
of the ID.
inputs: Request body matching the model's Input schema (model
page → API → Input schema), e.g.
``{"prompt": "a cat", "aspect_ratio": "16:9", "seed": 42}``.
wait_for_completion: If true, poll until done and return the
result inline.
timeout_seconds: Max wait when wait_for_completion=true.
File inputs must be publicly accessible HTTPS URLs that a plain
unauthenticated GET can fetch, e.g.
``{"image_url": "https://example.com/photo.webp"}``.
To run a Trainer LoRA without deploying it, call the LoRA's *base
model* ID here and pass the LoRA in the body, e.g.
``{"lora": {"path": "my_first_lora_3000.safetensors"}}`` — either a
LoRA name from your RunComfy LoRA Assets or a public URL.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | No | ||
| model_id | Yes | ||
| timeout_seconds | No | ||
| wait_for_completion | No |