Exman AI 开发者开放平台

Exman AI 面向现代开发者与企业级客户，提供具备毫秒级时间戳、说话人分离 (Speaker Diarization)、大文件 Webhook 异步回调的语音转写引擎，以及主流大模型（LLM）的高性能聚合路由网关。

🚀 打开在线演练场 (Playground) 进入管理控制台 (Console)
💡 统一调用地址：
所有 API 统一收口于标准 HTTPS 443 端口：https://api.exman.ai/v1。天然支持官方 OpenAI Python / Node SDK，只需指定 base_url="https://api.exman.ai/v1" 即可平滑无缝接入。

鉴权方式 (Authentication)

所有开放标准接口均采用标准的 HTTP Bearer Token 规范进行鉴权。在请求头中携带：

Authorization: Bearer <YOUR_EXMAN_API_KEY>

企业管理员可在 Exman 控制台随时生成具有独立预算额度、自定义速率限制（RPM/TPM）的专属 API Key。

1. 高保真音频转录 (Audio Transcriptions)

POST /v1/audio/transcriptions

兼容 OpenAI Whisper 官方规范，同时突破 25MB 体积限制（单文件支持高达 150MB），支持 Multipart 表单直传、公网 URL 及 Base64：

参数名类型必填说明
fileBinary File二选一Multipart 表单直接上传音频二进制 (mp3, wav, m4a, flac, aac, ogg)
file_urlString二选一音频文件的可访问公网直链 (JSON 格式提交)
modelString选填识别模型：whisper-1 或 exman-transcribe
languageString选填识别语种，默认 auto (自动探测)，支持 zh, en, ja, ko 等
diarizationBoolean选填是否启用说话人分离（区分 Speaker 1 / Speaker 2），默认 true
webhook_urlString选填异步回调通知地址（大文件传入此参数立即返回 202 并进入异步队列）
webhook_secretString选填用于计算 HMAC-SHA256 防篡改签名的密钥
 
# 同步调用示例
curl -X POST "https://api.exman.ai/v1/audio/transcriptions" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "file=@meeting.mp3" \
  -F "model=whisper-1" \
  -F "language=zh"

响应示例 (200 OK):

{
  "text": "大家下午好，今天我们主要讨论第三季度的架构升级与高并发支持规划。",
  "duration": 18.5,
  "language": "zh",
  "segments": [
    {
      "start": 0.04,
      "end": 6.20,
      "text": "大家下午好，今天我们主要讨论第三季度的架构升级与高并发支持规划。",
      "speaker": "Speaker 1"
    }
  ]
}

2. 大文件 Webhook 异步回调机制

针对数十兆或数小时的长录音，为避免客户端 HTTP 超时挂起，Exman AI 原生提供 Webhook 异步解法。只要在提交转录请求时传入 webhook_url，服务将在 ≤ 0.5 秒内 立即返回 202 Accepted：

# 异步调用示例
curl -X POST "https://api.exman.ai/v1/audio/transcriptions" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "file=@long_meeting_2hours.mp3" \
  -F "webhook_url=https://your-service.com/api/transcribe-webhook" \
  -F "webhook_secret=my_custom_secret_key"

立即响应 (HTTP 202 Accepted):

{
  "task_id": "task_tx_mv4u6xnf_riehk3",
  "status": "processing",
  "stage": "transcribing",
  "poll_url": "/v1/audio/tasks/task_tx_mv4u6xnf_riehk3",
  "webhook_registered": true
}
Webhook POST 推送标准载荷：
{
  "event": "audio.transcription.completed",
  "event_id": "evt_mv4u6x_8a2d1f",
  "timestamp": 1728695200,
  "task": {
    "task_id": "task_tx_mv4u6xnf_riehk3",
    "status": "completed",
    "result": {
      "text": "会议全文内容...",
      "duration": 3612.4,
      "language": "zh",
      "segments": [
        { "speaker": "Speaker 1", "start": 0.0, "end": 12.5, "text": "各位同事好..." }
      ]
    }
  }
}

3. 任务状态与结果轮询

GET /v1/audio/tasks/:task_id

若客户端处于内网或无公网 Webhook 接收端，可随时轮询此接口获取任务进度与完整结果：

curl -X GET "https://api.exman.ai/v1/audio/tasks/task_tx_mv4u6xnf_riehk3" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

4. 转录 + 核心纪要一站式提炼

POST /v1/audio/extract

将音频转为逐字稿后，自动调用大语言模型完成分段摘要总览、核心要点与行动清单提取：

curl -X POST "https://api.exman.ai/v1/audio/extract" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "https://your-domain.com/sample_meeting.mp3",
    "template": "meeting",
    "custom_prompt": "重点关注财务预算与责任排期"
  }'

5. 执行 16 项专业 AI 纪要技能

POST /v1/audio/skills

对已有文本或对话直接套用垂直领域专业 Prompt 模板执行 AI 分析：

curl -X POST "https://api.exman.ai/v1/audio/skills" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "transcript": "张工：下周一必须完成网关灰度。李总：预算已经批复下来了。",
    "skill": "biz-action-items"
  }'

6. 大模型对话补全 (Chat Completions)

POST /v1/chat/completions

标准 OpenAI 格式 Chat API，聚合 DeepSeek、GPT-4o、Claude 等全球主流大模型：

curl -X POST "https://api.exman.ai/v1/chat/completions" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "messages": [
      {"role": "user", "content": "请简要介绍 Exman AI 的核心技术优势。"}
    ]
  }'

7. 获取全量可用模型 (Models)

GET /v1/models

查询当前 API Key 拥有调用权限的转录与对话模型矩阵：

curl -X GET "https://api.exman.ai/v1/models" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

企业级高可用架构 (SLA & Infrastructure)

Exman AI 采用分布式微服务与智能动态负载均衡架构：