# Train Ticket Ocr

> 识别红/蓝火车票和铁路电子客票的关键字段，返回结构化 JSON；适用于财务报销、出行管理、票据识别等需要提取车票信息的场景。

- Skill: `qq5855144/train-ticket-ocr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add qq5855144/train-ticket-ocr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qq5855144/train-ticket-ocr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: qq5855144 (https://skillmd.com/u/qq5855144)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qq5855144/train-ticket-ocr

---


## 能力概述

调用百度 OCR 接口，对火车票图片（红票/蓝票）或铁路电子客票（PDF/OFD）进行结构化识别，提取票号、车次、始发/到达站、日期时间、票价、席别、座位号、乘客姓名、身份证号等关键字段。

| 项目 | 值 |
|------|----|
| Endpoint | `POST https://app-bo4w33bsdqm9-api-Xa6JZxjyqZna-gateway.appmiaoda.com/rest/2.0/ocr/v1/train_ticket` |
| Content-Type | `application/x-www-form-urlencoded` |
| 认证模式 | `platform_managed`（密钥由平台注入） |
| 响应格式 | JSON — `words_result` 对象含所有识别字段 |
| 支持平台 | Web、MiniProgram |

Auth Header 为 `X-Gateway-Authorization: Bearer ${INTEGRATIONS_API_KEY}`（注意不是标准的 `Authorization`）。


**输入优先级**：`image`（Base64）> `url`（图片 URL）> `pdf_file`（PDF Base64）> `ofd_file`（OFD Base64）

## 生成期用法（Agent 直接调用）

生成期代码直接调用上游接口，适用于后台脚本批量处理场景。

详见 [references/train-ticket-api.md](references/train-ticket-api.md) — **生成期代码** 章节。

## 生成后用法（应用内通过 Edge Function 调用）

应用内需通过 Edge Function 代理调用，将 `INTEGRATIONS_API_KEY` 保留在服务端，避免密钥暴露给前端。

**平台差异**：Web 和 MiniProgram 均返回 JSON 结构化数据，响应格式相同，Edge Function 实现一致，前端调用方式略有差异（见下表）。

| 平台 | 调用方式 |
|------|----------|
| Web | `supabase.functions.invoke` 或原生 `fetch` |
| MiniProgram（Taro） | `supabase.functions.invoke` |

详见 [references/train-ticket-api.md](references/train-ticket-api.md) — **Edge Function 代码** 及 **前端调用代码** 章节。