开发平台 API - 奇灵Ai

专为数字人口播视频制作而生的Ai引擎

API Key

创建以 qlai_sk_ 开头的调用密钥，并管理已创建的 Key；完整密钥仅创建时显示一次。

名称	API 密钥	创建时间	最近调用时间	状态	操作

奇灵Ai 技能包 v1.7.7

支持 Codex、Work Buddy、豆包等主流 AI 工作台
安装对接模型更简单
适配更多主流 AI 工作台
稳定性更高，Token 不会失效
模型自动托管，防脱管防滥扣
支持在线升级，功能可不断更新
制作视频时间速度更快
制作视频进度更可视化

技能包安装指南

技能包下载

AI工作台下载

下载对应的 AI 工作台客户端，配合上方技能包即可开始创作。

GPT账号相关

Work Buddy 下载

Codex 下载

提示：选择对应客户端下载，若codex用户有关于GPT账号问题可以咨询客服。

开发文档

接入流程

codex与work buddy的接入方式相同。

下载对应版本的技能包（skill）。
导入到 Codex、Work Buddy 等工作台，并发送“帮我导入技能包”。
点击页面顶部“创建 API Key”，申请一个以 qlai_sk_ 开头的密钥，发送给工作台。
准备好所需素材即可开始制作，支持三种模式：完整数字人视频（文案 + 照片 + 参考音频）、纯配音（文案 + 参考音频）、成品音频配口型（照片 + 完整音频）。

请按工作台选择 Codex 版或 Work Buddy 版技能包。两个版本均会处理文件编码、幂等提交、进度轮询和结果下载。

鉴权与安全

每次请求都必须通过 Bearer 方式携带 API Key。密钥只会在创建时显示一次，请保存在环境变量或密钥管理器中。

HTTP

Authorization: Bearer qlai_sk_xxx
Content-Type: application/json
Idempotency-Key: your-request-unique-id

每个 Key 具有独立权限、速率限制和任务空间；灵感值与账号余额共用——网页端充值、后台调整均即时生效，无需为 API 单独充值。任务只能由创建它的 Key 查询或取消。

不要把 API Key 写入浏览器前端、公开仓库、截图或聊天记录。发生泄露后应立即停用并重新创建。

创建数字人视频

POSThttps://qlai.cc/v1/videos

字段	类型	要求	说明
`mode`	string	可选	`video`（默认，数字人视频）/ `audio`（纯配音）/ `video_audio`（成品音频配口型），详见下方模式对照表
`content`	string	必填*	2 至 2000 字口播文案；video / audio 模式必填，video_audio 模式可省略（仅作备注）
`image_data`	Data URL	必填*	JPG / PNG / WebP，原文件最大 8MB；video / video_audio 模式必填
`audio_data`	Data URL	必填	参考音频（video / audio 模式，≤4MB，建议 10–15 秒、口齿清楚、无杂音）或完整成品口播音频（video_audio 模式，≤12MB）
`voice_authorized`	boolean	必填	必须为 true，确认拥有合法授权
`resolution`	string	可选	1080 / 1440，默认 1080
`ratio`	string	可选	9:16 / 16:9，默认 9:16
`audio_duration`	number	可选	音频时长（秒）；video_audio 模式建议提供，计费预估更准确，最终按实际生成时长结算

三种制作模式对照（素材齐备并确认授权后再创建任务）：

模式	所需素材	产物
`video`（默认）	口播文案 + 人物照片 + 参考音频	数字人口播视频：先克隆声音合成配音，再生成口播视频并渲染，结果在 `video_url`
`audio`	口播文案 + 参考音频（无需照片）	完整配音音频（按参考音色朗读文案），结果在 `audio_url`
`video_audio`	人物照片 + 完整成品口播音频（无需文案）	数字人口播视频：直接按已有音频生成口型，结果在 `video_url`

素材建议：人物照片用半身照、面带笑容、清晰度高，避免全身照或表情过于严肃的照片；参考音频口齿清楚、普通话标准、无环境杂音与背景音乐，时长 10–15 秒为宜。

SHELL

curl -X POST 'https://qlai.cc/v1/videos' \
  -H 'Authorization: Bearer '$QLAI_API_KEY \
  -H 'Idempotency-Key: order-20260820-0001' \
  -H 'Content-Type: application/json' \
  --data @request.json

服务器返回 HTTP 202。data.id 是任务编号；相同幂等键与相同请求体会返回原任务，不会重复生成。

任务查询与取消

GEThttps://qlai.cc/v1/videos/{task_id}

POSThttps://qlai.cc/v1/videos/{task_id}/cancel

建议每 5 秒查询一次。状态包括 queued、processing、succeeded、failed 和 cancelled。

JSON

{
  "data": {
    "id": "video_xxx",
    "mode": "video",
    "status": "succeeded",
    "stage": "finalizing",
    "progress": 100,
    "result": {
      "video_url": "https://qlai.cc/api/v1/media/download/videos?file=xxx.mp4&exp=1756220400000&token=xxx",
      "audio_url": null,
      "duration_seconds": 15.2,
      "resolution": "1080",
      "ratio": "9:16"
    },
    "billing": { "chargedCredits": 0, "billingStatus": "not_charged" }
  },
  "request_id": "req_xxx"
}

生成文件当前保留 3 天。收到成功状态后应尽快下载并保存到自己的存储空间；下载链接带时效签名（30 分钟内有效），过期后重新查询任务即可获得新链接。

账户与灵感值

GEThttps://qlai.cc/v1/account

GEThttps://qlai.cc/v1/account/transactions

账户接口返回 Key 的权限范围、每分钟请求限制、可用灵感值与冻结灵感值。可用灵感值即账号余额，与网页创作共用：网页端充值后 API 立即可用，API 消耗也会同步减少账号余额。任务提交时冻结灵感值，成功后结算，失败或取消后退回。

错误处理

HTTP	错误代码	处理方式
400	`invalid_content` 等	检查字段、文件格式与授权确认
401	`invalid_api_key`	检查密钥是否正确或已停用
402	`insufficient_credits`	补充灵感值后使用新的幂等键提交
409	`idempotency_conflict`	不同请求不能复用同一个幂等键
429	`rate_limit_exceeded`	遵循 Retry-After 后重试
500 / 503	`internal_error`	保留 request_id 并稍后重试

所有错误都返回 error.code、error.message 和 request_id。向技术支持反馈时只提供 request_id，不要提供 API Key。