Developers / API 开放平台

把象派引擎，接进你的产品

一组 REST 接口调用平台成像能力：提交即受理（202），轮询取结果；Bearer ApiKey 鉴权，与账号共用同一套积分账本——生成不成功，冻结积分自动全额退回。

申请 API Key 阅读接入文档 →

Capabilities

一个 Key，调用平台成像全栈

统一异步任务模型：提交返回任务 ID，轮询取结果；参考图支持 data URL 与站内 URL 直传。图像与视频开放 API 已上线；漫剧目前仅站内可用。

TEXT TO IMAGE

已开放

文生图

一句描述生成成品图。三档引擎按需选择：象派·疾影 Lite（标准 1K，10 积分/张起）、象派·显影 Pro（2K 高清精绘）、象派·幻彩 Max（高端精编辑）。比例 1:1 / 3:4 / 4:3 / 16:9 / 9:16，最高 4K。

IMAGE TO IMAGE

已开放

图生图 / 高清放大

多参考图改图（单引擎最多 14 张），自动注入主体一致性锚点：人物锁性别五官，产品锁外观、材质与 Logo。支持局部修改句式与 upscale 一键放大至 4K。

TEXT / IMAGE TO VIDEO

已开放

视频生成

文生视频 / 图生视频，象派·流影系列引擎，480p 至 2K 清晰度按秒计费，首尾帧不加收。开放 API：POST /api/v1/videos/generations（需 videos:generate）；MCP：generate_video / get_video_task。

AI COMIC DRAMA

站内上线 · API 规划中

漫剧工坊

从剧本到成片的流水线：分镜脚本 → 静帧 → 视频 → 配音 → 合成，按环节透明计费、失败环节自动退款。当前在站内漫剧工坊可用，API 化排期中。

REST + JSON，统一 { ok, data / error } 形状

异步 202 受理 + 轮询取结果

Bearer ApiKey（qp_live_）鉴权

MCP Server 内置，Agent 免手写 HTTP

失败自动解冻退款，任务 ID 幂等

Quickstart

三步，接入第一张图

新账号手机号验证即登录（注册不送积分），充值后即可联调。以下命令均为真实端点，替换密钥后即可直接运行。

申请 API Key

登录后进入个人中心 → API 密钥，点「新建密钥」即可。密钥 qp_live_ 开头，服务端只存 SHA-256 哈希——明文仅创建时返回一次，请立即妥善保存；泄露可随时吊销，立即生效。

默认权限域 images:generate,videos:generate，与账号共享积分账本（含所在企业共享池）。

API 方式创建（可选 · 需登录会话）

curl -X POST https://image.qiepai.ai/api/keys \
  -H "Content-Type: application/json" \
  -H "Cookie: <你的登录会话>" \
  -d '{ "name": "我的服务" }'

# → 201 {"ok":true,"data":{
#     "key":"qp_live_…",   // 明文仅此一次返回
#     "record":{"id":"…","prefix":"qp_live_ab12…","status":"active"} }}

绝大多数集成方直接在个人中心点按钮创建即可；此接口面向需要脚本化开通的场景。

发起首次调用

提交 POST /api/v1/images/generations，服务端完成内容审核与余额预检后 202 立即返回任务 ID，出图在后台异步执行。不传 model 时使用平台默认档（出厂默认象派·疾影 Lite，后台可配）； size 默认 1024x1024，n 支持 1–4 张。

图生图：加传 referenceImages（data URL 或站内 URL，单张 ≤25MB）即可，未传 mode 时自动按 image2image 处理。完整参数表见接入文档。

cURL · 首次调用

curl -X POST https://image.qiepai.ai/api/v1/images/generations \
  -H "Authorization: Bearer qp_live_你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只立于涟漪之上的青鹭，水墨渐变，东方意境",
    "size": "1024x1024",
    "n": 1
  }'

# → 202 {"ok":true,"data":{
#     "generationId":"cmu7a…",   // 任务 ID，轮询用
#     "status":"processing",
#     "creditsFrozen":10,        // 本次冻结积分，成功才实扣
#     "demo":false }}

轮询查结果

用同一把 Key 轮询 GET /api/v1/images/generations/{generationId}，建议间隔 2 秒。状态机 queued → rendering → succeeded / failed：succeeded 取 images 数组；failed 时冻结积分已自动退回。

数据隔离：仅返回由该 Key 创建的任务，他人任务与站内会话任务一律 404，不暴露存在性。

cURL · 轮询任务

curl https://image.qiepai.ai/api/v1/images/generations/cmu7a… \
  -H "Authorization: Bearer qp_live_你的密钥"

# → 200 {"ok":true,"data":{
#     "id":"cmu7a…",
#     "status":"succeeded",
#     "images":["/uploads/cmu7a…-f82fbbad8417.png"],
#     "creditsCost":10,
#     "createdAt":"2026-09-18T09:30:00.000Z" }}
# 完整字段（model / size / thumbUrl / error 等）见接入文档

MCP Server

平台内置 MCP 服务端（POST /api/mcp，工具：generate_image / get_generation / generate_video / get_video_task）—— Kimi、Claude 等支持 MCP 的 Agent 配上 Key 即可直接出图与出视频，无需手写 HTTP 集成。能力与 v1 REST 完全对齐：文生图 / 图生图（参考图改图、多图参考、局部修改）/ 高清放大 / 文生视频 / 图生视频。图片提交返回引擎名（engine）与预期时长（eta：疾影 Lite 10–30s / 显影 Pro 30–70s / 幻彩 Max 35–60s）；视频需 Key 含 videos:generate，建议 10s 轮询 get_video_task。风格一致场景请锁定 model，不要换引擎重试。

MCP 配置示例 →

Billing

计费说明

API 调用与站内创作共用同一套积分账本：积分单价随套餐 ¥0.085–0.10 / 积分；提交任务时按预估冻结积分，成功实扣、失败自动全额退回，以任务 ID 为幂等键，不会重复扣费。企业成员消费优先冻结所在组织的共享积分池，池余额不足时整笔回落个人账户。

场景	积分
象派·疾影 Lite · 标准（1K/2K 同价）	10 积分 / 张
象派·显影 Pro · 精绘（各尺寸同价）	22 积分 / 张
象派·幻彩 Max · 高端精编辑（quality high）	65 积分 / 张
高清放大 · 4K	5 积分 / 张
图生图 · 参考图解析附加费	+2 积分 / 张

多张开图按张数乘算；冻结后即使费率调整，在途任务仍按冻结时金额结算。视频按秒计费、漫剧按环节计费，详见定价页；套餐充值同样在定价页完成，到账后 API 立即可用。

手机号验证即登录 · 密钥秒级开通 · 失败不计费

申请 API Key，开始接入先读接入文档 →