deepseek

1# DeepSeek
2 
3## Purpose
4Call the DeepSeek API from Muse: list the currently available models, run OpenAI-compatible chat completions (with thinking mode and sampling controls), and check the account balance. Reach for this when the user wants an answer from a DeepSeek model or wants to inspect their DeepSeek account.
5 
6## Tooling
7All commands go through `bin/deepseek.py`:
8 
9```bash
10bin/deepseek.py auth                                              # verify the API key
11bin/deepseek.py models                                            # list available models
12bin/deepseek.py chat --message "Explain recursion in one sentence" \
13    --model deepseek-flash                                        # chat completion (SPENDS)
14bin/deepseek.py chat --message "Solve: 2x+5=17" \
15    --model deepseek-v4-pro --system "Show your work." \
16    --temperature 0.2 --max-tokens 500                             # with options
17bin/deepseek.py balance                                           # account balance
18```
19 
20The chat command prints the reply plus token usage and a cost note. Thinking-mode
21models also return `reasoning_content` when the API provides it.
22 
23## Auth
24- Provider id: `deepseek` (credential is collected as `custom.deepseek`)
25- Collection: API key (platform.deepseek.com > API keys) via the secure credential flow (`credentials.request_api_access`)
26- Auth scheme: `Authorization: Bearer <api key>` on every request
27- Allowed hosts: `api.deepseek.com`
28- Status check: `bin/deepseek.py auth`
29…