paddlepaddle--paddleocr/api_sdk/go/README_cn.md

PaddleOCR Go SDK

English | 简体中文

面向 PaddleOCR 官方 API 的 Go 客户端。它会把 OCR 和文档解析任务提交到 PaddleOCR 官方托管服务；不会运行本地 PaddleOCR 推理，也不会加载本地模型。

正式用户文档：

• Go SDK
• Go SDK（英文）

安装

go get github.com/PaddlePaddle/PaddleOCR/api_sdk/go

版本化发布使用 api_sdk/go/v0.1.0 这类子目录 module tag。

最小示例

设置 PADDLEOCR_ACCESS_TOKEN，或在构造客户端时传入 WithToken：

export PADDLEOCR_ACCESS_TOKEN="your-access-token"

client, err := paddleocr.NewClient()
if err != nil {
	return err
}

result, err := client.OCR(ctx, &paddleocr.OCRRequest{
	Model:   paddleocr.PPOCRv5,
	FileURL: "https://example.com/invoice.pdf",
})
if err != nil {
	return err
}
fmt.Println(result.JobID, len(result.Pages))

将 Model 设为 paddleocr.PPOCRv6（或 "PP-OCRv6"）可使用 PP-OCRv6 云端 OCR 模型。 将 Model 设为 paddleocr.PPOCRv5Latin（或 "PP-OCRv5-latin"）可使用 PP-OCRv5 拉丁语系云端 OCR 模型。

文档解析默认使用 PaddleOCR-VL-1.6：

doc, err := client.ParseDocument(ctx, &paddleocr.DocParsingRequest{
	FilePath: "./report.pdf",
	Options: &paddleocr.PaddleOCRVLOptions{
		UseChartRecognition: paddleocr.Bool(true),
	},
})
if err != nil {
	return err
}
fmt.Println(doc.JobID, len(doc.Pages))

构建与测试

go test ./...
go vet ./...
go test -race ./...

公开发布前建议运行 go test -race ./...。