Docs

API 文档

给接入方复制即用的 OCR、Inpaint 和图片清理接口说明。

快速开始

三步完成服务端接入。

1. 创建 API Key在 API 密钥页创建,并保存明文 Key。
2. 充值余额余额不足会返回 402,不调用底层能力。
3. 调用接口通过 Authorization Bearer 传入 API Key。

鉴权方式

API Key 只适合服务端保存,不要放到浏览器端。

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json
支持 OCR支持 Inpaint按次扣费

OCR API

识别图片 URL 中的文字、置信度和四点坐标。

curl -X POST https://api.example.com/openapi/v1/ocr \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/product.jpg"}'
{
  "code": 0,
  "message": "ok",
  "data": {
    "request_id": "req_202606260001",
    "items": [
      {"text":"shop1466182301631.1688.com","score":0.996,"box":[407,755,770,779]}
    ],
    "billing": {"amount": 1, "currency": "CNY"}
  }
}

Inpaint API

传入原图和 mask,返回修复后的图片 URL。

curl -X POST https://api.example.com/openapi/v1/inpaint \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url":"https://example.com/product.jpg",
    "mask_url":"https://example.com/mask.png"
  }'

错误码

开放 API 的通用错误返回。

401API Key 无效或已禁用
402余额不足,请先充值
403能力未开启或 Key 无权限
429调用频率过高
500服务异常或远程能力失败