Configuration

Default file: config/default.yaml.

Override path with env MOCK_MY_AI_CONFIG=/path/to.yaml.

Server

Key	Default	Notes
server.host	0.0.0.0	Also MOCK_MY_AI_HOST
server.port	8000	Also MOCK_MY_AI_PORT
server.docs_enabled	true	OpenAPI UI at /api/docs

Auth

Light format checks only — never validated against a real provider.

• Accepted prefixes: sk-mock-, sk-ant-mock-, AIzaMock
• Disable with auth.require_api_key: false or env MOCK_MY_AI_REQUIRE_API_KEY=false

Generation

Key	Meaning
tool_loop_min / tool_loop_max	Random tool rounds when tools are present (0–10)
cache_ratio_*	Prompt cached_tokens ratio (20–80%)
deepseek_cache_ratio_*	For model IDs containing deepseek (90–99%)
thinking_enabled_default	Default reasoning blocks
search_enabled_default	Default mock search

Per-request overrides (all families where applicable):

• mock_thinking (bool)
• mock_search (bool)
• mock_tool_rounds (int 0–10)
• mock_seed (int) for reproducible picks

Tools

tools:
  enabled: [echo, list_files]
  list_files_root: "./"
  list_files_max: 50

Custom models

models:
  custom:
    - id: "my-org/custom-mock-1"
      owned_by: "custom"
      family: "openai"
      features:
        thinking: true
        search: false
        multimodal_input: true