API 文档 - 奇灵AI

快速开始

奇灵AI开放 API 提供数字人图片生成、口播视频生成、声音克隆等能力，帮助开发者快速将 AI 数字人集成到自己的产品中。

调用流程

1. 注册账号并登录奇灵AI平台
2. 在个人中心创建并获取你的 API Key
3. 调用接口创建生成任务
4. 通过任务 ID 轮询查询任务结果
5. 任务完成后下载或回源获取生成文件

💡 所有接口均通过 HTTPS 调用，请求与响应均采用 JSON 格式，字符编码统一为 UTF-8。

⚠️ 本文档当前为 UI 原型演示，接口地址与参数仅为示例。正式接入以正式版 API 文档为准。

鉴权方式

所有 API 请求都需要在 Authorization 请求头中携带你的 API Key：

HTTP

# 请求头示例
Authorization: Bearer your-api-key-here
Content-Type: application/json

API Key 在个人中心创建。请妥善保管你的 API Key，切勿泄露给他人。如发现泄露，请立即在个人中心重置。

获取 API Key

登录平台后，进入 个人中心 → API 管理
点击「创建 API Key」，生成专属密钥
支持创建多个 Key，可分别设置权限与备注

数字人图片生成

上传参考照片与提示词标签，生成高清数字人形象图片。

POST https://api.qlai.cc/v1/image/generate

请求参数

参数	类型	必填	说明
`ref_image`	string	是	参考照片 URL（支持 JPG/PNG）
`tags`	array	是	提示词标签数组，如 ["写实风格","高清人像"]
`prompt`	string	否	补充描述文本
`ratio`	string	否	画面比例，默认 1:1

SHELL

curl -X POST 'https://api.qlai.cc/v1/image/generate' \
  -H 'Authorization: Bearer your-api-key-here' \
  -H 'Content-Type: application/json' \
  -d '{
    "ref_image": "https://example.com/photo.jpg",
    "tags": ["写实风格", "高清人像"],
    "prompt": "正装，微笑，办公室背景"
  }'

响应示例

JSON

{
  "code": 0,
  "data": {
    "task_id": "img_20260817_001",
    "status": "processing"
  },
  "message": "ok"
}

数字人视频生成

基于数字人形象、声音与文案，生成口播视频。

POST https://api.qlai.cc/v1/video/generate

请求参数

参数	类型	必填	说明
`avatar_id`	string	是	数字人形象 ID
`voice_id`	string	是	声音 ID（克隆声音或平台音色）
`content`	string	是	说话内容文案
`resolution`	string	否	分辨率 480/720/1080，默认 480
`action_desc`	string	否	动作与镜头描述

SHELL

curl -X POST 'https://api.qlai.cc/v1/video/generate' \
  -H 'Authorization: Bearer your-api-key-here' \
  -H 'Content-Type: application/json' \
  -d '{
    "avatar_id": "avatar_001",
    "voice_id": "voice_002",
    "content": "大家好，欢迎来到奇灵AI",
    "resolution": "1080"
  }'

声音克隆

上传本人声音样本，创建专属声音模型。

POST https://api.qlai.cc/v1/voice/clone

请求参数

参数	类型	必填	说明
`audio_url`	string	是	声音样本 URL（30秒以上清晰人声）
`name`	string	是	声音名称
`authorization_confirmation`	boolean	是	确认拥有该声音使用权

⚠️ 声音克隆仅支持本人声音，上传即代表你确认拥有该声音的合法使用授权。任何侵犯他人权益的行为由使用者承担全部责任。

任务查询

通过任务 ID 查询生成任务的状态与结果。

GET https://api.qlai.cc/v1/task/{task_id}

响应示例

JSON

{
  "code": 0,
  "data": {
    "task_id": "video_20260817_001",
    "status": "succeeded",  // processing | succeeded | failed
    "result": {
      "video_url": "https://cdn.qlai.cc/video/xxx.mp4",
      "duration": 32,
      "resolution": "1080p"
    },
    "cost_credits": 12
  }
}

💡 生成任务为异步处理，建议每 5 秒轮询一次任务状态。企业客户可接入任务回调（Webhook），任务完成时平台自动推送结果。

错误码

接口统一返回 code 字段，0 表示成功，非 0 表示失败：

错误码	说明
`0`	成功
`10001`	参数错误，请检查请求参数
`10002`	鉴权失败，API Key 无效或已过期
`10003`	积分不足，请充值后再试
`10004`	接口限流，请降低请求频率
`20001`	文件上传失败或格式不支持
`20002`	声音克隆未通过授权校验
`50000`	服务器内部错误，请稍后重试