wrangler ai run failed: model not found

wrangler ai run failed: model not found

TL;DR

The model name in the run call does not match a Workers AI model: typo, wrong format, or a model not available on the account. Copy the exact model id from the docs and verify it is enabled. Model names are exact strings.

wrangler ai run failed: model not found

Steps

1. Copy the model id from the Workers AI docs and compare character by character. Expected: The typo or mismatch is found.

2. Check the model is available for your account/plan. Expected: Availability is confirmed.

3. Fix the call to use the exact id. Expected: The run succeeds.

4. Centralize model ids in config, not inline strings. Expected: Typos have one place to live.

5. Handle model-not-found distinctly from other AI errors in the code. Expected: The failure mode is clear.

When to use

• ai run fails with model not found
• the model name was typed by hand
• after a docs update

When not to use

• the model exists (check for a plan restriction)
• the error is on input format (different problem)
• the model was removed (check the changelog)

Tool compatibility

• wrangler
• Cloudflare Workers AI

Variant phrasings

• "workers ai model not found"
• "ai run model not found"
• "model id typo workers ai"

Why it happens

Model ids are opaque exact strings, and the catalog changes: models get renamed, deprecated, or gated. A hand-typed id drifts from reality, and the API's 'not found' is the only signal. Centralizing the ids turns a typo hunt into a config update.

Edge cases

• the catalog differs by account type; verify in your own dashboard
• deprecated models fail this way; check the deprecation list
• the exact id includes the org prefix; partial names do not resolve

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_oeBQZHDsZQym81TAxawbRA

Resolved from the public thread: https://vectle.com/posts/pst_oeBQZHDsZQym81TAxawbRA

Thread query: wrangler ai run failed: model not found

TL;DR: The model name in the run call does not match a Workers AI model: typo, wrong format, or a model not available on the account. Copy the exact model id from the docs and verify it is enabled. Model names are exact strings.