> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek API:写代码与推理的省钱之选

> 为什么 DeepSeek 在价格和质量上最划算,V4 Pro 与 Flash 有何区别,家族擅长什么(代码、推理)、又不能做什么(无 vision)。走 OpenAI 兼容协议接入。

大家选 DeepSeek 就一个理由:代码和推理接近顶级质量,但比其他模型明显便宜。家族有两个模型 —— 旗舰 `deepseek-v4-pro` 和快速低价的 `deepseek-v4-flash`。两者都是纯文本、长上下文,走 OpenAI 兼容协议。本页讲 DeepSeek 什么时候划算、擅长什么、又不能做什么。

## 为什么 DeepSeek 是省钱之选

核心卖点是性价比。DeepSeek 在代码和逻辑上给出的结果接近顶级模型,但单价低得多。如果你有大批量请求、长文档,或者对成本敏感的 CI 流水线,DeepSeek 通常能把账单降到几分之一,而质量几乎不打折。

* **单价** —— 在强模型里属于最低一档;`deepseek-v4-flash` 比旗舰还便宜。
* **质量** —— 推理和代码贴近顶级,不是「经济舱」水平。
* **容量** —— 长上下文让你不必把文档切成小块。

精确的单价请见 [www.ruapi.ai](https://www.ruapi.ai) 的\*\*「价格」\*\*页。

## Pro 还是 Flash 怎么选

|      | `deepseek-v4-pro` | `deepseek-v4-flash` |
| ---- | ----------------- | ------------------- |
| 定位   | 旗舰                | 快速便宜                |
| 擅长   | 最好质量:难代码、严谨推理、分析  | 日常任务的速度与价格          |
| 函数调用 | 可靠的 tool use      | 基础,适合简单场景           |
| 价格   | 较高(仍很便宜)          | 最低                  |
| 适合   | 难任务、智能体           | 对话、分类、大批量           |

<Tip>
  拿不准就从 Flash 起步:又快又几乎不花钱,覆盖大多数任务。需要最好结果时再上 Pro:难代码、精准推理、可靠的工具调用。
</Tip>

## DeepSeek 的强项:代码与推理

这正是这条线被选中的两大原因。

* **代码** —— Pro 写代码、补全、重构都很稳,能解释报错并给出修改建议。适合自动补全、代码审查、生成测试。
* **推理** —— 模型能逐步拆解难题:数学、逻辑、需求分析、智能体的行动规划。
* **长上下文** —— 大文件和长文档能整段放进窗口,无需切块。
* **函数调用** —— Pro 返回结构化工具调用;完整示例见[函数调用](/zh/function-calling)。

回答较长时,可以[流式输出](/zh/streaming),让回答逐字打出来,不用等整段生成完。

## DeepSeek 不能做什么

<Note>
  DeepSeek 是**纯文本**模型。不能把图片当输入,没有 vision:`deepseek-v4-pro` 和 `deepseek-v4-flash` 都读不了图片、图表或截图。需要看图请用带视觉的模型 —— [Claude](/zh/claude-api)、[Gemini](/zh/gemini-api) 或 [GLM-5V](/zh/glm-api)。同一把密钥、同一个 `base_url` 适用于所有线,所以可以混搭:文本和代码用 DeepSeek,图片交给视觉模型。
</Note>

## 接入 DeepSeek

DeepSeek 走 **OpenAI 兼容**协议 —— 不用单独的库。拿任意 OpenAI SDK,把 `base_url` 改成 `https://www.ruapi.ai/v1`,在 `model` 字段填上想用的 ID:

```python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="你的_RUAPI_密钥",
    base_url="https://www.ruapi.ai/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-pro",   # 或 deepseek-v4-flash
    messages=[{"role": "user", "content": "用 Python 写一个快速排序函数"}],
)
print(resp.choices[0].message.content)
```

逐步配置、密钥,以及 Python 和 curl 的第一个请求见[快速入门](/zh/quickstart)。精确的模型 ID 和价格见 [www.ruapi.ai](https://www.ruapi.ai) 的「价格」页。

## 接下来

<CardGroup cols={2}>
  <Card title="接入与第一个请求" icon="bolt" href="/zh/quickstart">
    base\_url、密钥、Python 和 curl 代码。
  </Card>

  <Card title="Claude 模型" icon="brain" href="/zh/claude-api">
    同一把密钥 —— 顶级质量和视觉能力。
  </Card>

  <Card title="GLM 模型" icon="cube" href="/zh/glm-api">
    另一条高性价比线,还带视觉选项(GLM-5V)。
  </Card>
</CardGroup>