zshot/cliDownload

Cloudflare

Default model
@cf/cloudflare/clef
Key envCLOUDFLARE_API_KEY
LicensePro

Runs a Workers AI model under a Cloudflare account, named as the string’s host or by CLOUDFLARE_ACCOUNT_ID. The model’s protocol sets what it does:

protocol=ModelsRuns as
typesafeDecision models, such as Cleftypesafe does: navigator only, choosing among listed alternatives
openaiChat models, such as @cf/openai/gpt-oss-120bA chat provider, which also formats and writes

Without protocol=, a model under @cf/cloudflare/clef speaks typesafe and any other openai. A bare model name names one of Cloudflare’s own, so clef is @cf/cloudflare/clef.

Options

OptionOn Cloudflare
protocoltypesafe or openai, from the model when absent
gatewayThe AI Gateway each call goes through, as CLOUDFLARE_GATEWAY_ID names it
visionA decision model is shown screenshots at stall:3. A chat model is off by default; vision=true opts in one that reads images
body.<path>Chat models; fields OpenAI’s chat request names
header, max_tokens, temperature, top_p, frames, timeoutAs listed; the chat options apply to chat models

Example

A Clef navigator with a writer:

CLI Run locally
zshot --navigate "Open the formats page" \
  --navigator-type "cloudflare://?name=scout" \
  --navigator-type "anthropic://?name=writer&writer=true" \
  -f out.png https://zshot-cli.com/

A chat model formatting, through a gateway:

CLI Run locally
zshot -t llm_text \
  --llm-format-model "cloudflare://?model=@cf/openai/gpt-oss-120b&gateway=my-gateway" \
  --llm-format-prompt "Summarize the lead story in one sentence." \
  -f summary.txt https://zshot-cli.com/example_assets/gazette/