Skip to content

Running a Generation

This guide walks through running a workflow from comfyclaw.app and watching live progress.

1) Choose a Workflow

Select a workflow card to view its description, pricing, and input form. Inputs are auto‑generated from the workflow schema.

2) Fill Inputs

Input types include:

  • Text prompts
  • Numeric fields (steps, seed, CFG, etc.)
  • File uploads (images/audio)
  • Dropdowns for sampler or model choices

3) Submit Job

When you click Generate, the app sends:

POST /api/v1/jobs
Authorization: Bearer ccn_sk_...
Content-Type: application/json

{
  "workflow_id": "<id>",
  "inputs": {
    "13.text": "a neon city at night",
    "5.seed": -1
  }
}

The response returns a job_id.

4) Live Progress + Previews

The job status endpoint includes:

  • progress (0 → 1)
  • preview image (base64)
  • smart_messages (human‑friendly progress messages)
GET /api/v1/jobs/<job_id>
Authorization: Bearer ccn_sk_...

Previews are generated by the provider and streamed through the gateway in real time.

5) Download Output

GET /api/v1/jobs/<job_id>/output
Authorization: Bearer ccn_sk_...

If cloud storage is enabled, the gateway can return a presigned URL with ?url=1.