ArtKit API 接口文档

ArtKit 提供标准的 RESTful API 接口，让你可以轻松将 AI 智能抠图、图片处理、PDF 工具、签名设计等全平台能力集成到任何应用中。

接口介绍

ArtKit API 支持以下核心能力：

• AI 一键去除图片背景，输出透明 PNG
• 批量处理多张图片，返回 ZIP 压缩包
• 智能去水印、图片压缩、添加水印
• 艺术效果：转素描、铅笔画、油画、动漫风格
• 美颜磨皮、降噪清晰化、黑白上色
• 证件照制作与识别、OCR 文字识别
• 头像制作、格式转换、长图拼接、拼图、缩放
• PDF 合并/拆分/压缩/转图片/转文本/OCR
• 二维码生成与解析、条形码生成
• GIF 压缩/分解、视频转 GIF、音频剪切/合并
• 文本去重、排版清理、加密解密、时间戳转换
• JSON 格式化、随机密码生成、单位换算
• 艺术签名设计、电子签名生成
• 支持 JPG / PNG / WebP / TIFF / AVIF 格式，最大 10MB（媒体文件 50MB）

图片类 API 使用 multipart/form-data 方式上传，文本/签名类 API 使用 application/json。所有功能接口均需认证。

鉴权方式

ArtKit API 使用 API Key 进行鉴权。你可以在 控制台 创建和管理 API Key。

认证方式一：HTTP Header（推荐）

在请求头中添加 X-API-Key：

X-API-Key: ak_your_api_key_here

认证方式二：Query 参数

在 URL 中添加 api_key 参数：

POST /api/remove-bg?api_key=ak_your_api_key_here

认证方式三：Bearer Token

使用登录获取的 JWT Token：

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

获取 API Key 步骤

1. 注册账户 或 登录
2. 进入 控制台
3. 在「API Keys」部分点击「创建 API Key」
4. 复制并妥善保管生成的 Key（仅显示一次）

方案与限额

请求频率限制：每个 IP 每 15 分钟最多 100 次请求。

注意：同一账号下创建的多个 API Key 共享每日使用次数限制，不会叠加。例如：专业版用户创建了 5 个 Key，5 个 Key 合计每日最多使用 500 次。

API Key 管理接口

以下接口需要使用 JWT Token（Bearer Token）认证，用于管理 API Key。

{
  "email": "user@example.com",
  "password": "your_password",
  "name": "Your Name"
}

{
  "message": "注册成功",
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": "...", "email": "...", "name": "...", "plan": "free" }
}

{ "email": "user@example.com", "password": "your_password" }

{ "message": "登录成功", "token": "eyJ...", "user": { ... } }

{ "name": "生产环境" }

{
  "message": "API Key 创建成功，请妥善保管",
  "key": {
    "id": "uuid",
    "key": "ak_abc123def456...",
    "name": "生产环境",
    "createdAt": "2026-01-01T00:00:00.000Z"
  }
}

{ "keys": [{ "id": "...", "key": "ak_abc1****f456", "name": "...", "usageCount": 42 }] }

{ "message": "API Key 已删除" }

账号管理

获取用户信息、使用量统计、修改方案及密码管理。

{ "user": { "id": "...", "email": "...", "name": "...", "plan": "free", "usage": { "today": 3, "total": 42 } } }

{ "usage": { "today": 3, "todayDate": "2026-01-15", "total": 42, "limit": 5 } }

{ "user": { ... }, "limits": { "dailyLimit": 500, "batchSize": 20 } }

{ "message": "密码修改成功" }

{ "message": "如果该邮箱已注册，重置链接已发送", "token": "abc123..." }

{ "message": "密码重置成功，请使用新密码登录" }

支付接口

用于管理付费订阅。目前支持支付宝和微信支付（演示模式）。

{ "plans": [{ "id": "pro_monthly", "plan": "pro", "priceYuan": "29.00", "label": "专业版 - 月付", "duration": 30 }, ...] }

{ "order": { "id": "...", "amount": 2900, "status": "pending" }, "qrContent": "artkit-pay://...", "message": "订单创建成功，请扫码支付" }

{ "message": "支付成功", "order": { "id": "...", "status": "paid", "plan": "pro" } }

{ "orders": [{ "id": "...", "priceId": "pro_monthly", "amount": 2900, "status": "paid", "paidAt": "..." }] }

{ "order": { "id": "...", "userId": "...", "priceId": "pro_monthly", "amount": 2900, "payMethod": "alipay", "status": "paid", "paidAt": "...", "expiresAt": "..." } }

错误处理

当请求失败时，API 返回 JSON 格式的错误信息：

{
  "error": "错误描述信息",
  "code": 400
}

单图抠图

Content-Type: image/png
Content-Disposition: inline; filename="artkit_1234567890.png"

{
  "error": "请上传图片文件",
  "code": 400
}

批量抠图

Content-Type: application/zip
Content-Disposition: attachment; filename="artkit_batch_1234567890.zip"

背景替换

图片信息

{
  "width": 1920,
  "height": 1080,
  "format": "jpeg",
  "size": 524288,
  "channels": 3,
  "hasAlpha": false
}

去水印

Content-Type: image/png
Content-Disposition: inline; filename="artkit_nowm_1234567890.png"

{
  "error": "请上传水印蒙版",
  "code": 400
}

健康检查

{
  "status": "ok",
  "aiEngine": "ready",
  "timestamp": "2026-03-15T12:00:00.000Z",
  "uptime": 3600,
  "version": "1.0.0"
}

图片压缩

添加水印

图片转动漫

老照片修复

图片去模糊

黑白照片上色

图片旋转

图片降噪

图片缩放

图片转素描

图片转铅笔画

图片转油画

人脸美颜

证件照制作

证件照识别

{
  "width": 413,
  "height": 579,
  "format": "jpeg",
  "size": 52488,
  "dpi": 300,
  "background": { "dominantColor": "#438edb", "name": "蓝色" },
  "matchedSpec": "2寸 (35×49mm)"
}

OCR 文字识别

{
  "text": "识别到的文字内容...",
  "confidence": 92
}

头像制作

图片格式转换

长图拼接

# cURL 示例
curl -X POST https://artkit.cn/api/stitch \
  -H "X-API-Key: ak_your_key" \
  -F "images=@img1.jpg" \
  -F "images=@img2.jpg" \
  -F "images=@img3.jpg" \
  -F "direction=vertical" \
  -o stitched.png

拼图

# cURL 示例
curl -X POST https://artkit.cn/api/collage \
  -H "X-API-Key: ak_your_key" \
  -F "images=@img1.jpg" \
  -F "images=@img2.jpg" \
  -F "images=@img3.jpg" \
  -F "images=@img4.jpg" \
  -F "columns=2" \
  -o collage.png

PDF 合并

将多个 PDF 文件合并为一个 PDF。

PDF 拆分

按页码范围拆分 PDF 文件。

PDF 压缩

压缩 PDF 文件大小。

PDF 转图片

将 PDF 每页转换为 PNG 图片，打包为 ZIP 返回。

PDF 转文本

提取 PDF 中的文字内容。

{
  "text": "提取到的全部文字...",
  "pages": 5,
  "info": { "Title": "...", "Author": "..." }
}

PDF 扫描件 OCR

对扫描件 PDF 进行 OCR 文字识别。先尝试提取文本，若文本过少则对前 5 页进行 OCR 识别。

{
  "text": "识别出的文字...",
  "method": "text-extraction | ocr",
  "pages": 5
}

二维码生成

输入文本或链接生成二维码图片。

二维码解析

从上传的图片中识别并解码二维码。

{ "text": "https://artkit.cn", "found": true }

条形码生成

生成标准条形码图片。

GIF 压缩

压缩 GIF 文件大小，可调整尺寸和色彩数。

GIF 分解

将动态 GIF 拆分为逐帧 PNG 图片。

视频转 GIF

将视频转换为 GIF 动图（需服务器安装 FFmpeg）。

视频提取音频

从视频文件中提取音频轨道。

音频剪切

截取音频文件的指定时间段。

音频合并

将多个音频文件按顺序合并为一个。

音视频格式转换

音视频格式轻量级互转。

文本去重

按行去除重复内容。

{ "result": "去重后的文本", "originalLines": 10, "uniqueLines": 7, "removedLines": 3 }

排版清理

去空行、去首尾空格、全角转半角、合并连续空格。

{ "result": "清理后的文本" }

加密解密

MD5、SHA-256、SHA-512 哈希计算和 Base64 编码/解码。

{ "result": "e10adc3949ba59abbe56...", "algorithm": "md5", "action": "hash" }

时间戳转换

Unix 时间戳与日期时间双向转换，自动识别输入格式。

{ "timestamp": 1700000000, "timestampMs": 1700000000000, "iso": "2023-11-14T22:13:20.000Z", "local": "2023/11/15 06:13:20", "direction": "timestamp-to-date" }

JSON 格式化

JSON 美化缩进或压缩，自动语法校验。

{ "result": "{\n  \"key\": \"value\"\n}", "valid": true }

随机密码生成

生成自定义长度和字符类型的随机密码。

{ "passwords": ["Xy$3kQ9...", "aB!7mN2..."], "length": 16, "count": 5 }

单位换算

长度、重量、温度等常用单位换算。

{ "value": 1, "from": "km", "to": "m", "result": 1000, "type": "length" }

艺术签名设计

生成多种风格的艺术签名图片，支持优雅、粗犷、手写、印章、艺术等风格。

电子签名

生成手写风格电子签名图片，可用于合同、文档等电子签名场景。

代码示例 - cURL

复制# 单图抠图（使用 API Key 鉴权）
curl -X POST https://artkit.cn/api/remove-bg \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "image=@photo.jpg" \
  -o result.png

# 指定白色背景
curl -X POST https://artkit.cn/api/remove-bg \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "image=@photo.jpg" \
  -F "bgColor=white" \
  -o result.png

# 去水印
curl -X POST https://artkit.cn/api/remove-watermark \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "image=@photo.jpg" \
  -F "mask=@mask.png" \
  -o result_clean.png

# 批量抠图
curl -X POST https://artkit.cn/api/batch-remove-bg \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "images=@photo1.jpg" \
  -F "images=@photo2.jpg" \
  -F "images=@photo3.jpg" \
  -o result.zip

# 健康检查（无需鉴权）
curl https://artkit.cn/api/health

# 注册账户
curl -X POST https://artkit.cn/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"your_password","name":"YourName"}'

# 创建 API Key
curl -X POST https://artkit.cn/api/auth/api-keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"生产环境"}'

# ── PDF 工具 ──
# PDF 合并
curl -X POST https://artkit.cn/api/pdf-merge \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "files=@doc1.pdf" \
  -F "files=@doc2.pdf" \
  -o merged.pdf

# PDF 拆分
curl -X POST https://artkit.cn/api/pdf-split \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "file=@document.pdf" \
  -F "pages=1-3,5" \
  -o split.pdf

# ── 二维码/条码 ──
# 生成二维码
curl -X POST https://artkit.cn/api/qr-generate \
  -H "X-API-Key: ak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text":"https://artkit.cn","width":300}' \
  -o qrcode.png

# ── GIF/音视频 ──
# GIF 压缩
curl -X POST https://artkit.cn/api/gif-compress \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "file=@animation.gif" \
  -o compressed.gif

# 视频提取音频
curl -X POST https://artkit.cn/api/extract-audio \
  -H "X-API-Key: ak_your_api_key_here" \
  -F "file=@video.mp4" \
  -F "format=mp3" \
  -o audio.mp3

# ── 文本工具 ──
# 文本去重
curl -X POST https://artkit.cn/api/text-dedup \
  -H "X-API-Key: ak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text":"line1\nline2\nline1"}'

# 加密（MD5）
curl -X POST https://artkit.cn/api/crypto \
  -H "X-API-Key: ak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello","algorithm":"md5"}'

# ── 签名工具 ──
# 艺术签名
curl -X POST https://artkit.cn/api/art-signature \
  -H "X-API-Key: ak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"张三","style":"elegant","color":"#1a1a2e"}' \
  -o signature.png

# 电子签名
curl -X POST https://artkit.cn/api/e-signature \
  -H "X-API-Key: ak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"张三","color":"#000000"}' \
  -o esign.png

代码示例 - Python

复制import requests

API_KEY = "ak_your_api_key_here"
HEADERS = {"X-API-Key": API_KEY}

# 单图抠图
def remove_background(image_path, output_path="result.png", bg_color="transparent"):
    with open(image_path, "rb") as f:
        resp = requests.post(
            "https://artkit.cn/api/remove-bg",
            headers=HEADERS,
            files={"image": f},
            data={"bgColor": bg_color}
        )
    
    if resp.status_code == 200:
        with open(output_path, "wb") as out:
            out.write(resp.content)
        print(f" 已保存到 {output_path}")
    else:
        print(f" 错误: {resp.json()['error']}")

# 调用
remove_background("photo.jpg")
remove_background("photo.jpg", "white_bg.png", "white")

# 批量抠图
def batch_remove(image_paths, output_zip="batch.zip"):
    files = [("images", open(p, "rb")) for p in image_paths]
    resp = requests.post(
        "https://artkit.cn/api/batch-remove-bg",
        headers=HEADERS,
        files=files
    )
    
    if resp.status_code == 200:
        with open(output_zip, "wb") as out:
            out.write(resp.content)
        print(f" 批量结果已保存到 {output_zip}")

batch_remove(["photo1.jpg", "photo2.jpg", "photo3.jpg"])

# ── PDF 合并 ──
def merge_pdfs(pdf_paths, output="merged.pdf"):
    files = [("files", open(p, "rb")) for p in pdf_paths]
    resp = requests.post(
        "https://artkit.cn/api/pdf-merge",
        headers=HEADERS,
        files=files
    )
    if resp.status_code == 200:
        with open(output, "wb") as out:
            out.write(resp.content)
        print(f" 合并完成: {output}")

merge_pdfs(["doc1.pdf", "doc2.pdf"])

# ── 二维码生成 ──
def generate_qr(text, width=300, output="qr.png"):
    resp = requests.post(
        "https://artkit.cn/api/qr-generate",
        headers={**HEADERS, "Content-Type": "application/json"},
        json={"text": text, "width": width}
    )
    if resp.status_code == 200:
        with open(output, "wb") as out:
            out.write(resp.content)
        print(f" 二维码已生成: {output}")

generate_qr("https://artkit.cn")

# ── 艺术签名 ──
def art_signature(name, style="elegant", color="#1a1a2e", output="sign.png"):
    resp = requests.post(
        "https://artkit.cn/api/art-signature",
        headers={**HEADERS, "Content-Type": "application/json"},
        json={"name": name, "style": style, "color": color}
    )
    if resp.status_code == 200:
        with open(output, "wb") as out:
            out.write(resp.content)
        print(f" 签名已生成: {output}")

art_signature("张三", style="handwriting")

# ── 文本加密 ──
def crypto_text(text, algorithm="md5"):
    resp = requests.post(
        "https://artkit.cn/api/crypto",
        headers={**HEADERS, "Content-Type": "application/json"},
        json={"text": text, "algorithm": algorithm}
    )
    if resp.status_code == 200:
        data = resp.json()
        print(f" {algorithm.upper()}: {data['result']}")
    return resp.json()

crypto_text("hello", "sha256")

代码示例 - Node.js

复制import fs from 'fs';
import FormData from 'form-data';
import fetch from 'node-fetch';

const API_KEY = 'ak_your_api_key_here';

// 单图抠图
async function removeBg(imagePath, outputPath = 'result.png') {
  const form = new FormData();
  form.append('image', fs.createReadStream(imagePath));
  form.append('bgColor', 'transparent');

  const resp = await fetch('https://artkit.cn/api/remove-bg', {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY },
    body: form,
  });

  if (resp.ok) {
    const buffer = Buffer.from(await resp.arrayBuffer());
    fs.writeFileSync(outputPath, buffer);
    console.log(` 已保存到 ${outputPath}`);
  } else {
    const err = await resp.json();
    console.error(` 错误: ${err.error}`);
  }
}

removeBg('photo.jpg');

// 批量抠图
async function batchRemoveBg(imagePaths, outputZip = 'batch.zip') {
  const form = new FormData();
  imagePaths.forEach(p => form.append('images', fs.createReadStream(p)));

  const resp = await fetch('https://artkit.cn/api/batch-remove-bg', {
    method: 'POST',
    body: form,
  });

  if (resp.ok) {
    const buffer = Buffer.from(await resp.arrayBuffer());
    fs.writeFileSync(outputZip, buffer);
    console.log(` 批量结果已保存到 ${outputZip}`);
  }
}

batchRemoveBg(['photo1.jpg', 'photo2.jpg']);

// ── 二维码生成 ──
async function generateQR(text, width = 300, outputPath = 'qr.png') {
  const resp = await fetch('https://artkit.cn/api/qr-generate', {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ text, width }),
  });
  if (resp.ok) {
    const buffer = Buffer.from(await resp.arrayBuffer());
    fs.writeFileSync(outputPath, buffer);
    console.log(` 二维码已生成: ${outputPath}`);
  }
}

generateQR('https://artkit.cn');

// ── 艺术签名 ──
async function artSignature(name, style = 'elegant', outputPath = 'sign.png') {
  const resp = await fetch('https://artkit.cn/api/art-signature', {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ name, style, color: '#1a1a2e' }),
  });
  if (resp.ok) {
    const buffer = Buffer.from(await resp.arrayBuffer());
    fs.writeFileSync(outputPath, buffer);
    console.log(` 签名已生成: ${outputPath}`);
  }
}

artSignature('张三', 'handwriting');

// ── 文本加密 ──
async function cryptoText(text, algorithm = 'md5') {
  const resp = await fetch('https://artkit.cn/api/crypto', {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ text, algorithm }),
  });
  if (resp.ok) {
    const data = await resp.json();
    console.log(` ${algorithm.toUpperCase()}: ${data.result}`);
  }
}

cryptoText('hello', 'sha256');

代码示例 - Java

复制import java.net.http.*;
import java.net.URI;
import java.nio.file.*;

public class ArtKitAPI {
    private static final String BASE_URL = "https://artkit.cn";
    private static final String API_KEY = "ak_your_api_key_here";

    public static byte[] removeBg(String imagePath) throws Exception {
        String boundary = "----ArtKit" + System.currentTimeMillis();
        byte[] fileBytes = Files.readAllBytes(Path.of(imagePath));
        String fileName = Path.of(imagePath).getFileName().toString();

        String body = "--" + boundary + "\r\n"
            + "Content-Disposition: form-data; name=\"image\"; filename=\"" + fileName + "\"\r\n"
            + "Content-Type: image/jpeg\r\n\r\n";
        String end = "\r\n--" + boundary + "--\r\n";

        byte[] bodyBytes = body.getBytes();
        byte[] endBytes = end.getBytes();
        byte[] payload = new byte[bodyBytes.length + fileBytes.length + endBytes.length];
        System.arraycopy(bodyBytes, 0, payload, 0, bodyBytes.length);
        System.arraycopy(fileBytes, 0, payload, bodyBytes.length, fileBytes.length);
        System.arraycopy(endBytes, 0, payload, bodyBytes.length + fileBytes.length, endBytes.length);

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/api/remove-bg"))
            .header("Content-Type", "multipart/form-data; boundary=" + boundary)
            .header("X-API-Key", API_KEY)
            .POST(HttpRequest.BodyPublishers.ofByteArray(payload))
            .build();

        HttpResponse<byte[]> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofByteArray());

        if (response.statusCode() == 200) {
            Files.write(Path.of("result.png"), response.body());
            System.out.println(" 已保存到 result.png");
        }
        return response.body();
    }

    public static void main(String[] args) throws Exception {
        removeBg("photo.jpg");

        // 二维码生成
        generateQR("https://artkit.cn");

        // 艺术签名
        artSignature("张三", "elegant");
    }

    // 二维码生成
    public static void generateQR(String text) throws Exception {
        String json = "{\"text\":\"" + text + "\",\"width\":300}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/api/qr-generate"))
            .header("X-API-Key", API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<byte[]> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofByteArray());

        if (response.statusCode() == 200) {
            Files.write(Path.of("qr.png"), response.body());
            System.out.println(" 二维码已生成");
        }
    }

    // 艺术签名
    public static void artSignature(String name, String style) throws Exception {
        String json = "{\"name\":\"" + name + "\",\"style\":\"" + style + "\",\"color\":\"#1a1a2e\"}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/api/art-signature"))
            .header("X-API-Key", API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<byte[]> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofByteArray());

        if (response.statusCode() == 200) {
            Files.write(Path.of("signature.png"), response.body());
            System.out.println(" 签名已生成");
        }
    }
}