XHS Cover
集成文档

快速接入指南

OpenClaw Skill 一键安装，或使用零依赖 CLI 直接调用

认证方式

Authentication

所有方式都需要 API Key。最快方式：npx xhscover setup 自动注册获取。

export XHS_COVER_API_KEY="xhs_your_api_key"
在控制台中获取您的 API Key：xhscover.cn/dashboard

OpenClaw Skill（推荐）

一行命令安装，AI Agent 自然语言调用

通过自然语言指令直接调用，无需编写代码。安装后首次使用会自动引导注册。

安装命令

clawhub install xhs-cover

手动安装（备选）

cd ~/.openclaw/workspace
git clone https://github.com/xwchris/xhs-cover-skill.git skills/xhs-cover
GitHub: xwchris/xhs-cover-skill

使用示例

•生成小红书封面："5个习惯让你越来越自律"
•生成小红书封面："今日份好心情" 宽高比 1:1
•查看我的 credit 余额

使用流程

  1. 1安装 Skill：clawhub install xhs-cover
  2. 2对 AI 说「帮我生成一个小红书封面」— 首次使用自动引导注册，注册即获 10 个免费积分
  3. 3后续直接说「生成封面」「查余额」即可，无需再次配置

CLI 工具

跨平台 CLI，npx 一键使用

独立的命令行工具，适用于非 OpenClaw 场景。支持 macOS、Linux、Windows，需 Node.js >= 18。

首次使用

# 注册账号并自动配置（注册即获 10 个免费积分）
npx xhscover setup

使用

# 生成封面（默认 3:4 竖版）
npx xhscover generate "5个习惯让你越来越自律"

# 指定宽高比
npx xhscover generate "今日份好心情" 1:1

# 查询余额
npx xhscover balance

# 查看历史
npx xhscover history
GitHub: xwchris/xhscover-cli · npm: xhscover

REST API 接口

如果您需要直接调用 REST API，以下是可用的端点

生成封面

Generate Cover

POST
https://api.xhscover.cn/api/v1/generate

请求参数

{
  "text": "5个习惯让你越来越自律",
  "aspectRatio": "3:4"  // 可选，默认 3:4
}

响应示例

{
  "success": true,
  "taskId": "uuid",
  "resultUrl": "https://...",
  "creditCost": 10
}

cURL 示例

curl -X POST https://api.xhscover.cn/api/v1/generate \
  -H "X-API-Key: xhs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "5个习惯让你越来越自律"}'

查询余额

Get Credits

GET
https://api.xhscover.cn/api/v1/credits

响应示例

{
  "balance": 10,
  "totalPurchased": 0,
  "totalUsed": 0
}

支持的宽高比

Supported Aspect Ratios

3:4
9:16
1:1
16:9
4:3
2:3
5:4
4:5

MCP 协议集成

Model Context Protocol（备选方案）

如果您使用 Claude Desktop、Cursor、Windsurf 等 MCP 兼容工具，也可以通过 MCP Server 接入。相比 Skill/CLI 方案，需要 Node.js 环境。

Claude Desktop 配置

{
  "mcpServers": {
    "xhs-cover": {
      "command": "npx",
      "args": ["-y", "@emit/xhs-cover-mcp-server"],
      "env": {
        "XHS_COVER_API_URL": "https://api.xhscover.cn",
        "XHS_COVER_API_KEY": "xhs_your_api_key"
      }
    }
  }
}

可用的 MCP 工具

generate_cover生成小红书封面图片
get_credits查询账户 Credit 余额
get_history获取生成历史记录
npm: @emit/xhs-cover-mcp-server

错误码

Error Codes

状态码说明
401API Key 无效
402Credit 余额不足
400请求参数错误
500服务器错误
免费注册返回首页