XHS Cover
AI Agent 集成文档

Skill AI 自动接入

支持 MCP 协议和 OpenClaw Skill，让 AI Agent 自动调用服务能力

认证方式

Authentication

所有 API 请求需要在 Header 中携带 API Key：

X-API-Key: xhs_your_api_key
您可以在控制台中获取您的 API Key

MCP 协议集成

Model Context Protocol

通过 MCP 协议，您可以在 Claude Desktop、Cursor、Windsurf 等 AI 工具中直接使用服务能力，AI Agent 会自动调用相应的接口。

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获取生成历史记录

OpenClaw Skill

一键安装到 OpenClaw Agent

使用 ClawHub 一键安装 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 余额

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

错误码

Error Codes

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