御码 AI 能力平台开放 API 文档

认证

API Key 在平台「密钥管理」中创建，请求时携带以下任一请求头：

X-API-Key: sk-xxxxxxxx
# 或
Authorization: Bearer sk-xxxxxxxx

对话补全（OpenAI 兼容）

与 OpenAI Chat Completions 同形：请求、响应、流式事件格式完全一致。model 填平台已启用的模型名（可通过 GET /v1/models 查询）。

POST https://ai.yumakeji.cn/api/v1/openai/v1/chat/completions
{
  "model": "平台已启用的模型名",
  "messages": [
    {"role": "system", "content": "你是一个政务咨询助手"},
    {"role": "user", "content": "你好"}
  ],
  "stream": true
}

OCR 文字识别

支持图片（PNG/JPG/WebP/BMP）与 PDF（逐页识别）。返回识别文本、页数与引擎标识。适合合同扫描件、票据、证件等场景。

POST https://ai.yumakeji.cn/api/v1/openai/v1/ocr
{
  "image_base64": "<图片base64>",
  "filename": "contract.pdf"
}

# 响应
{ "text": "识别出的全文...", "pages": 3, "engine": "paddleocr-vl" }

语音识别 ASR 与合成 TTS

POST /api/v1/openai/v1/audio/transcriptions — multipart 上传音频，返回识别文本。

POST /api/v1/openai/v1/audio/speech — 文本转语音，返回音频流。

Anthropic 兼容端点

/api/v1/anthropic/v1/messages 与 /v1/ocr 提供同能力的 Anthropic 消息格式，便于已有 Anthropic SDK 的系统零改造接入。

计费

按用量计入租户 token 账户（识别类按返回文本量估算，OCR 请求有预检保底）。额度与用量可在平台后台查看。