接口文档

ZPP AI 提供兼容 OpenAI / Anthropic 的统一 API，支持对话、图像、视频、音频与 OCR 能力。

Base URL

所有 API 请求统一使用以下地址作为 Base URL：

text

https://api.zppai.cn/v1

鉴权方式

所有请求需在 HTTP Header 中携带 API Key：

http

Authorization: Bearer sk-zpp-xxxxxxxxxxxxxxxx

API Key 可在控制台的 API Keys 页面创建。

错误码

API 使用标准 HTTP 状态码，常见错误如下：

json

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error"
  }
}

获取模型列表

GEThttps://api.zppai.cn/v1/models

返回当前平台所有可用模型，兼容 OpenAI `GET /v1/models` 格式。

对话补全

POSThttps://api.zppai.cn/v1/chat/completions

兼容 OpenAI Chat Completions API，支持流式 SSE 输出。

Responses API

POSThttps://api.zppai.cn/v1/responses

兼容 OpenAI Responses API，适用于 Codex 等工具。

图像生成

POSThttps://api.zppai.cn/v1/images/generations

兼容 OpenAI Images API，支持常见图像模型。

Anthropic 兼容

POSThttps://api.zppai.cn/v1/messages

兼容 Anthropic Messages API，适用于 Claude Code 等工具。

视频生成

POSThttps://api.zppai.cn/v1/videos/generations

支持视频生成模型。

音频

POSThttps://api.zppai.cn/v1/audio/speech

POSThttps://api.zppai.cn/v1/audio/transcriptions

通用 OCR 识别

POSThttps://api.zppai.cn/api/ext/ocr/recognize

此接口为付费接口，请求体使用 multipart/form-data。

请求参数

参数	类型	必填	说明
`file`	file	是	待识别图片文件
`ocrType`	string	是	识别类别，见下方枚举表

ocrType 识别类别枚举

类别	类型	说明
通用识别	`GENERAL`	通用文字识别
个人证照	`ID_CARD`	居民身份证
个人证照	`BANK_CARD`	银行卡
个人证照	`SOCIAL_SECURITY_CARD`	社保卡
个人证照	`HOUSEHOLD_REGISTER`	户口本
个人证照	`BIRTH_CERTIFICATE`	出生医学证明
个人证照	`HK_MACAU_PASS`	往来港澳通行证
个人证照	`TAIWAN_PASS`	往来台湾通行证
个人证照	`TAIWAN_MAINLAND_PASS`	台湾居民来往大陆通行证
个人证照	`HK_MAINLAND_PASS`	港澳居民来往内地通行证
行业资质	`BUSINESS_LICENSE`	营业执照
行业资质	`SOCIAL_ORG_REG`	社会团体法人登记证书
行业资质	`TRADE_UNION_REG`	工会法人资格证书
行业资质	`PRIVATE_NON_ENTERPRISE_REG`	民办非企业单位登记证书
行业资质	`INSTITUTION_LEGAL_REG`	事业单位法人证书
行业资质	`UNIFIED_SOCIAL_CREDIT_REG`	统一社会信用代码证书
财务票据	`VAT_INVOICE`	增值税发票
财务票据	`VAT_ROLL_INVOICE`	增值税卷票
财务票据	`TAXI_INVOICE`	出租车发票
财务票据	`TRAIN_TICKET`	火车票
财务票据	`AIRPORT_TICKET`	航空运输电子客票行程单
财务票据	`VEHICLE_SALE_INVOICE`	机动车销售统一发票
财务票据	`QUOTA_INVOICE`	定额发票
财务票据	`TOLL_INVOICE`	过路过桥费发票
财务票据	`MEDICAL_INVOICE`	医疗门诊发票
财务票据	`TAX_CERTIFICATE`	税收完税证明
财务票据	`SHIP_TICKET`	船票
财务票据	`NON_TAX_BILL`	非税票据
财务票据	`GENERAL_MACHINE_INVOICE`	通用机打发票
财务票据	`BUS_TICKET`	汽车票

bash

curl -X POST https://api.zppai.cn/api/ext/ocr/recognize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg" \
  -F "ocrType=ID_CARD"

余额查询

GEThttps://api.zppai.cn/v1/usage

查询当前 API Key 所属用户的账户余额。

ZPP AI · Base URL: https://api.zppai.cn/v1