Provider Health
Provider health tells you whether Synth can call the models it needs for extraction, linking, and lint. Explore does not require a provider.
Use The UI
Go to Settings -> Providers and run Test Provider before a large ingest.
For LiteLLM and other OpenAI-compatible gateways, Test Provider verifies the configured route with a minimal completion. A virtual key may be healthy even when it cannot list models. Enter the route manually when discovery is denied; see LiteLLM & OpenAI-Compatible Gateways. Use Settings -> Models to assign models for extract, link, and lint.
What To Check
- key is present
- provider endpoint is reachable
- selected model exists
- provider has enough quota
- extraction and linking agents have a model assigned
Common Fixes
| Problem | Fix |
|---|---|
| provider missing | add key in Settings -> Providers or env var |
| model not found | choose a listed model, or verify the exact manual route alias for a gateway |
| ingest fails before extraction | configure the extract agent |
| Explore fails but ingestion works | check Project readiness and canonical index status |
| costs too high | use a cheaper extract/link model |
After the test passes, ingest a small source and confirm Explore returns its evidence. Explore itself remains provider-free.
Environment Keys
export OPENCODE_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...