AI Agent 快速开始

为 Claude Code、OpenClaw 等 AI Agent 提供 qise.cc API 接入指南

获取 API Key

请先登录账号以获取 API Key

复制指令给 AI Agent

使用 qise.cc 的 OpenAPI（给外部 Agent 调用，API Key 鉴权）：

API Key: ak_xxxxxxxxxxxxxxxx
Base URL: https://motu-api.qise.cc

图片输入：本地文件先 POST https://motu-api.qise.cc/api/v1/images/upload 上传，用 data.signedUrl 或 data.signed_url；远程 URL 直接传入，无需上传。

异步任务：若 POST 返回 data.status 为 pending 或 processing，必须轮询直至 completed/failed（勿依赖 async_mode 开关）：
- 抠图、高清放大：GET https://motu-api.qise.cc/api/v1/open/image/tasks/{taskId 或 task_id}
- 智能扩图、图片翻译、文生图、图生图：GET https://motu-api.qise.cc/api/v1/open/ai/generations/{jobId、taskId 或 task_id}

结果图片：优先从 data.results[] 取第一项的 url；兼容旧字段 result.imageUrl / image_url。错误判断：仅当 code 为数字且非 0 时视为失败（code 为 null/省略时勿当错误）。

可用功能：
- 智能抠图: POST /api/v1/open/image/remove-bg
- 高清放大: POST /api/v1/open/image/upscale
- 智能扩图: POST /api/v1/open/image/outpainting
- 图片翻译: POST /api/v1/open/image/translation
- 文生图:   POST /api/v1/open/ai/generations (type=text_to_image)
- 图生图:   POST /api/v1/open/ai/generations (type=image_to_image)

接口说明（给 Agent 阅读）：
- 打开：https://qise.cc/agent/docs
- 或使用本页面底部“接口说明文档”卡片进入

使用示例：
"请帮我把 ./photo.jpg 的背景去掉，保存为 ./result.png"
"请将 ./image.jpg 放大 2 倍"
"请把 ./poster.jpg 的中文翻译成英文"
"请把 ./photo.jpg 向四周扩展 50%"

支持的 AI 工具

智能抠图

1点/张

高清放大

2点/张

智能扩图

按量计费

图片翻译

按量计费

文生图

按量计费

图生图

按量计费

当前选择：智能抠图

Base Path: /api/v1/open 鉴权: Authorization: Bearer <API_KEY> **POST** /image/remove-bg 图片：本地先 POST /api/v1/images/upload，远程 URL 直接传 image_url 若 data.status 为 pending/processing：轮询 GET /image/tasks/{taskId|task_id}；字段兼容 camelCase（如 taskId、results[].url）

代码示例

import requests
import sys

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://motu-api.qise.cc"

# 本地图片需先上传，远程 URL 可跳过此步
base = BASE_URL.rstrip("/").replace("/api/v1/open", "") or BASE_URL
with open("image.jpg", "rb") as f:
    up = requests.post(
        f"{base}/api/v1/images/upload",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": f}
    )
    ud = up.json().get("data") or {}
    image_url = ud.get("signedUrl") or ud.get("signed_url")

# 调用工具
resp = requests.post(
  f"{BASE_URL}/api/v1/open/image/remove-bg",
  headers={"Authorization": f"Bearer {API_KEY}"},
  json={
  "image_url": image_url,
  "output_format": "png",
  "return_mask": false,
  "only_mask": false,
  "async_mode": false
}
)
j = resp.json()
code = j.get("code")
if code is not None and code != 0:
    print("API error:", j, file=sys.stderr)
    sys.exit(1)
data = j.get("data") or {}
tid = data.get("jobId") or data.get("job_id") or data.get("taskId") or data.get("task_id")
status = data.get("status")
if status in ("pending", "processing") and tid:
    import time
    while status in ("pending", "processing"):
        time.sleep(3)
        r = requests.get(
            f"{BASE_URL}/api/v1/open/image/tasks/{tid}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        j2 = r.json()
        c2 = j2.get("code")
        if c2 is not None and c2 != 0:
            print("poll error:", j2, file=sys.stderr)
            sys.exit(1)
        data = (j2.get("data") or {})
        status = data.get("status")
        if status in ("completed", "failed"):
            break
    results = data.get("results") or []
    first = results[0] if results else {}
    url = first.get("url") or first.get("imageUrl") or first.get("image_url")
    if not url:
        r0 = data.get("result") or {}
        url = r0.get("imageUrl") or r0.get("image_url")
    print({"status": status, "image_url": url, "data": data})
else:
    print(j)

接口说明文档（给 Agent 阅读）

将每个工具的 endpoint、请求体与返回结构整理成可直接复制给 AI Agent 的 Markdown。