CLI reference

obraz render

obraz render --prompt TEXT --lora FILE --lora-strength N --trigger-word WORD --allow-provider-cost
             [--json]

Renders one image through the Obraz at OBRAZ_URL, authenticated with the secret OBRAZ_SECRET_ROLE names (see configuration), with the recipe: the trigger word leads the prompt, the adapter applies at --lora-strength, which the creator's recipe states, and the frame is the service's OBRAZ_FRAME. A render is billed, so the command refuses without --allow-provider-cost.

job_id: <id>
prompt: <trigger word>, <prompt>
url: <image url>
mime_type: -

prompt is the prompt as rendered. With --json the whole answer as JSON: success, job_id, prompt, url, and mime_type when the service set it; fields with no value are left out.

Refusals

Exit 2, nothing sent:

refusing a billable render without explicit --allow-provider-cost

Exit 1: the caller configuration refusals; obraz at <url> — <cause> when the service cannot be reached; obraz refused (<status>): <reason> with the service's own reason, such as obraz refused (400): trigger_word is required: without it the adapter renders a stranger. A missing --prompt, --lora, --lora-strength or --trigger-word exits 2.