Metadata-Version: 2.4
Name: mzapi-multicloud-sdk
Version: 0.0.1
Summary: MZAPI - 集成多家云服务商 API 的多云统一接口库 (Python SDK)
Author-email: 祁潇潇 <qixiaoxin@stu.sqxy.edu.cn>
License: MPL-2.0
Project-URL: Bug Reports, https://github.com/xiaomizhoubaobei/MZAPI-Python/issues
Project-URL: Source, https://github.com/xiaomizhoubaobei/MZAPI-Python
Project-URL: Homepage, https://pypi.org/project/mzapi-multicloud-sdk
Project-URL: Download, https://pypi.org/project/mzapi-multicloud-sdk/#files
Project-URL: Changelog, https://github.com/xiaomizhoubaobei/MZAPI-Python/CHANGELOG.md
Project-URL: Documentation, https://docs.mizhoubaobei.top
Project-URL: GitHub, https://github.com/xiaomizhoubaobei/MZAPI-Python
Keywords: API,SDK,MZAPI,PYTHON,MULTICLOUD,ALIYUN,TENCENTCLOUD,HUAWEICLOUD,OCR
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.33.0
Requires-Dist: pytz~=2026.1
Requires-Dist: simplejson>=3.20.0
Requires-Dist: alibabacloud-credentials>=1.0.0
Requires-Dist: alibabacloud-gateway-spi>=0.0.3
Requires-Dist: alibabacloud-tea>=0.4.0
Requires-Dist: darabonba-core>=1.0.0
Requires-Dist: cryptography>=46.0.7
Provides-Extra: dev
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Dynamic: license-file

# MZAPI - 多云服务统一 API 接口库

MZAPI (Multi-cloud API) 是一个集成多家云服务商 API 的多云统一接口库，提供统一、简洁的 Python SDK，让开发者可以用一致的方式调用腾讯云、阿里云、华为云等不同服务商的 API。

## ✨ 特性

- 🌐 **多云统一**：一套接口，对接多家云服务商
- 📦 **轻量易用**：简洁的 API 设计，快速上手
- 🔐 **安全可靠**：完整的认证与签名机制
- ⚡ **异步支持**：同步/异步双模式
- 🛡️ **稳定健壮**：熔断、重试、预连接优化

## 📦 安装

```bash
pip install mzapi-multicloud-sdk
```

## 🚀 快速开始

### 腾讯云 OCR

```python
from mzapi.tencentcloud import GeneralBasicOCR

client = GeneralBasicOCR(
    secret_id="your_secret_id",
    secret_key="your_secret_key",
)
result = client.recognize(image_base64="base64_encoded_image")
```

### 阿里云 OCR

```python
from mzapi.aliyun.ocr import RecognizeAllText

client = RecognizeAllText(
    access_key_id="your_access_key_id",
    access_key_secret="your_access_key_secret",
    endpoint="ocr-api.cn-hangzhou.aliyuncs.com",
)
result = client.recognize(url="https://example.com/image.jpg")
```

## 📚 支持的云服务

| 云服务商 | 服务 | 说明 |
|---------|------|------|
| 腾讯云 | OCR | 通用印刷体识别 |
| 阿里云 | OCR | 识别全部文字 |
| 华为云 | OCR | 光学字符识别 |

## 🔧 开发指南

### 环境要求

- Python >= 3.10

### 本地开发

```bash
# 克隆仓库
git clone https://github.com/xiaomizhoubaobei/MZAPI-Python.git
cd MZAPI-Python

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest tests/
```

## 📄 许可证

本项目采用 [MPL-2.0](LICENSE) 许可证。
