数字政府人工智能公共支撑平台API的使用

数字政府人工智能公共支撑平台（以深圳为例），是依托政务云构建的 “门户 + 中心 + 中台 + 安全体系”AI 公共底座，提供大模型、NLP、OCR、语音、图像等标准化能力 API，供政务部门安全、集约调用。

1. 申请入驻与认证

• 向平台管理单位（如市政务服务和数据管理局）提交应用入驻申请，填写应用信息、用途、调用量预估。
• 审核通过后，获取AppKey、AppSecret、API 网关地址、Token 获取地址。

2. API 请求（以文本生成为例）

• 接口地址：https://{网关地址}/api/v1/llm/completion
• 请求方式：POST
• 请求头：

Authorization: Bearer {accessToken} Content-Type: application/json

• 请求体（JSON）：

json

{ "model": "gov-text-base", "prompt": "请生成一份会议通知", "temperature": 0.7, "maxTokens": 1024 }

3. 发送请求并接收响应

• Python 示例：

python

运行

import requests import json url = "https://{网关地址}/api/v1/llm/completion" headers = { "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "Content-Type": "application/json" } data = { "model": "gov-text-base", "prompt": "请生成一份会议通知", "temperature": 0.7, "maxTokens": 1024 } response = requests.post(url, headers=headers, json=data) print(json.dumps(response.json(), ensure_ascii=False, indent=2))

4. 解析响应结果

• 成功响应（code=200）：

json

{ "code": 200, "msg": "success", "data": { "content": "会议通知\n各单位：\n定于2026年6月30日召开工作会议..." } }

• 错误响应（如 401=Token 无效、429 = 调用超限）：

json

{ "code": 401, "msg": "Token已过期", "data": null }

5. 错误处理与限流

• 常见错误：401 Token 过期、403 权限不足、429 QPS 超限、500 服务异常。
• 处理策略：Token 自动续期、请求重试（指数退避）、限流排队、异常日志上报。

1. OCR 文字识别

• 接口：/api/v1/ocr/general
• 请求：上传图片（base64 或 URL）
• 返回：识别文字、位置坐标。

2. 语音转文字

• 接口：/api/v1/asr/recognize
• 请求：音频文件（wav/mp3）
• 返回：转写文本、置信度。