> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/jp/moderu/tutorials/deepseek-ocr-2.md).

# DeepSeek-OCR 2: 実行とファインチューニングのガイド

DeepSeek-OCR-2をローカルで実行・ファインチューニングする方法のガイド。

**DeepSeek-OCR 2** は、DeepSeekが2026年1月27日に公開した、最先端の視覚認識と文書理解を実現する新しい30億パラメータモデルです。単なるテキスト抽出ではなく、より高度な視覚的推論を伴う画像からテキストへの変換に重点を置いています。

DeepSeek-OCR 2ではDeepEncoder V2を導入。これにより、モデルは人間と同じ論理的な順序で画像を「見る」ことができます。

画像を固定グリッド（左上から右下）で走査する従来の視覚LLMとは異なり、DeepEncoder V2はまず全体像を把握し、その後、人間のような読み取り順序、つまり何に最初に注目し、次に何を見るかなどを学習します。これにより、段組みをより正確にたどり、ラベルと値を対応付け、表を一貫して読み取り、テキストと構造が混在するレイアウトに対応できるため、複雑なレイアウトでのOCR性能が向上します。

Unslothでは、次の資料を使ってDeepSeek-OCR 2をファインチューニングできるようになりました。 [**無料のファインチューニング用ノートブック**](https://colab.research.google.com/github/unslothai/notebooks/blob/main/nb/Deepseek_OCR_\(3B\).ipynb)**.** 言語理解で [88.6%の向上](#fine-tuning-deepseek-ocr) を実証しました。

<a href="https://unsloth.ai/docs/jp/moderu/tutorials/deepseek-ocr-2.md#running-deepseek-ocr-2" class="button primary">DeepSeek-OCR 2の実行</a><a href="https://unsloth.ai/docs/jp/moderu/tutorials/deepseek-ocr-2.md#fine-tuning-deepseek-ocr-2" class="button secondary">DeepSeek-OCR 2のファインチューニング</a>

## 🖥️ **DeepSeek-OCR 2の実行**

最初のモデルと同様に、DeepSeek-OCR 2を最新のtransformersで推論と学習ができるように編集しました（精度に変更はありません）。 [こちら](https://huggingface.co/unsloth/DeepSeek-OCR-2).

モデルを [transformers](#transformers-run-deepseek-ocr-2-tutorial) または [Unsloth](#unsloth-run-deepseek-ocr-tutorial)で実行する場合の推奨設定は次のとおりです。

### :gear: 推奨設定

DeepSeekが推奨する設定は次のとおりです。

* <mark style="color:デフォルト;background-color:blue;">**Temperature = 0.0**</mark>
* `max_tokens = 8192`
* `ngram_size = 30`
* `window_size = 90`

**対応モード - 動的解像度：**

* デフォルト：(0-6)×768×768 + 1×1024×1024 — (0-6)×144 + 視覚トークン256個

**プロンプトの例：**

```
# document: <image>\n<|grounding|>Convert the document to markdown.
# other image: <image>\n<|grounding|>OCR this image.
# without layouts: <image>\nFree OCR.
# figures in document: <image>\nParse the figure.
# general: <image>\nDescribe this image in detail.
# rec: <image>\nLocate <|ref|>xxxx<|/ref|> in the image.
```

<div align="center"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FGff3UBRgiu0aFXsbwll2%2Ffig1.png?alt=media&amp;token=58864777-114a-450a-ab56-3cabc9219cf7" alt="" width="375"><figcaption><p>Visual Causal Flowを使って、あらゆる文書をMarkdownに変換します。</p></figcaption></figure></div>

### 🦥 Unsloth：DeepSeek-OCR 2の実行チュートリアル

1. 最新版の `unsloth` は次のコマンドで入手できます。 `pip install --upgrade unsloth` 。すでにUnslothをインストールしている場合は、次のコマンドで更新してください。 `pip install --upgrade --force-reinstall --no-deps --no-cache-dir unsloth unsloth_zoo`
2. 次に、以下のコードを使ってDeepSeek-OCR 2を実行します。

{% code overflow="wrap" %}

```python
from unsloth import FastVisionModel
import torch
from transformers import AutoModel
import os
os.environ["UNSLOTH_WARN_UNINITIALIZED"] = '0'

from huggingface_hub import snapshot_download
snapshot_download("unsloth/DeepSeek-OCR-2", local_dir = "deepseek_ocr")
model, tokenizer = FastVisionModel.from_pretrained(
    "./deepseek_ocr",
    load_in_4bit = False, # メモリ使用量を減らすには4bitを使用します。16bit LoRAの場合はFalse。
    auto_model = AutoModel,
    trust_remote_code = True,
    unsloth_force_compile = True,
    use_gradient_checkpointing = "unsloth", # 長いコンテキストではTrueまたは"unsloth"を指定します
)

prompt = "<image>\nFree OCR. "
image_file = 'your_image.jpg'
output_path = 'your/output/dir'
res = model.infer(tokenizer, prompt=prompt, image_file=image_file, output_path = output_path, base_size = 1024, image_size = 640, crop_mode=True, save_results = True, test_compress = False)
```

{% endcode %}

### 🤗 Transformers：DeepSeek-OCR 2 チュートリアルを実行する

NVIDIA GPUでHugging Face Transformersを使って推論します。Python 3.12.9 + CUDA 11.8でテスト済みの要件：

```bash
torch==2.6.0
transformers==4.46.3
tokenizers==0.20.3
einops
addict 
easydict
pip install flash-attn==2.7.3 --no-build-isolation
```

```python
from transformers import AutoModel, AutoTokenizer
import torch
import os
os.environ["CUDA_VISIBLE_DEVICES"] = '0'
model_name = 'unsloth/DeepSeek-OCR-2'

tokenizer = AutoTokenizer.from_pretrained(model_name, trust_remote_code=True)
model = AutoModel.from_pretrained(model_name, _attn_implementation='flash_attention_2', trust_remote_code=True, use_safetensors=True)
model = model.eval().cuda().to(torch.bfloat16)

# prompt = "<image>\nFree OCR. "
prompt = "<image>\n<|grounding|>Convert the document to markdown. "
image_file = 'your_image.jpg'
output_path = 'your/output/dir'

res = model.infer(tokenizer, prompt=prompt, image_file=image_file, output_path = output_path, base_size = 1024, image_size = 768, crop_mode=True, save_results = True)
```

## 🦥 **DeepSeek-OCR 2のファインチューニング**

UnslothはDeepSeek-OCR 2のファインチューニングに対応しました。最初のモデルと同様に、動作させるには [カスタムアップロード](https://huggingface.co/unsloth/DeepSeek-OCR-2) を使用して `transformers` ください（精度への影響はありません）。最初のモデルと同様に、Unslothでは精度を損なうことなく、DeepSeek-OCR-2を1.4倍高速にトレーニングでき、VRAM使用量を40%削減し、コンテキスト長を5倍にできます。\
\
無料のColabノートブックを使って、DeepSeek-OCR 2をファインチューニングできるようになりました。

* DeepSeek-OCR 2： [ファインチューニング専用ノートブック](https://colab.research.google.com/github/unslothai/notebooks/blob/main/nb/Deepseek_OCR_2_\(3B\).ipynb)

以下に、ペルシア語のCER（文字誤り率）の精度改善を示します。

#### サンプルごとのCER（10サンプル）

| インデックス | OCR1（変更前） | OCR1（変更後） | OCR2（変更前） | OCR2（変更後） |
| ------ | --------: | --------: | --------: | --------: |
| 1520   |    1.0000 |    0.8000 |   10.4000 |    1.0000 |
| 1521   |    0.0000 |    0.0000 |    2.6809 |    0.0213 |
| 1522   |    2.0833 |    0.5833 |    4.4167 |    1.0000 |
| 1523   |    0.2258 |    0.0645 |    0.8710 |    0.0968 |
| 1524   |    0.0882 |    0.1176 |    2.7647 |    0.0882 |
| 1525   |    0.1111 |    0.1111 |    0.9444 |    0.2222 |
| 1526   |    2.8571 |    0.8571 |    4.2857 |    0.7143 |
| 1527   |    3.5000 |    1.5000 |   13.2500 |    1.0000 |
| 1528   |    2.7500 |    1.5000 |    1.0000 |    1.0000 |
| 1529   |    2.2500 |    0.8750 |    1.2500 |    0.8750 |

#### 平均CER（10サンプル）

* **OCR1：** 変更前 **1.4866**、後 **0.6409** (**-57%**)
* **OCR2:** 前 **4.1863**、後 **0.6018** (**-86%**)

## 📊 ベンチマーク

DeepSeek-OCR 2モデルのベンチマークは、公式の研究論文に基づいています。

**表1：** OmniDocBench v1.5における文書読解の包括的な評価。V-token𝑚𝑎𝑥は、このベンチマークでページごとに使用される視覚トークン数の最大値を表します。R-orderは読み取り順序を示します。DeepSeek OCRおよびDeepSeek OCR 2を除き、この表に記載されたその他のモデルの結果はすべてOmniDocBenchリポジトリから取得されています。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FhxyKqi0rT9Jm4Y9PFqBY%2FScreenshot%202026-01-27%20at%201.14.02%E2%80%AFAM.optimized.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**表2：** OmniDocBench v1.5における文書要素の各カテゴリの編集距離。V-token𝑚𝑎𝑥は、視覚トークン数の最大値が最も低いことを示します。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FcTVu52ugTwQAqLdnQLLz%2FScreenshot%202026-01-27%20at%201.14.15%E2%80%AFAM.png?alt=media&amp;token=ec92a4a1-facb-4b63-90cd-73d23a41dcfb" alt="" width="563"><figcaption><p>OmniDocBenchでGemini-3 Proを上回る</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/jp/moderu/tutorials/deepseek-ocr-2.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
