SkillHub

pixshop-creative-api

v1.0.0

Pixshop 开发者 REST API — 图片生成/编辑、视频制作、提示词库、应用市场、社区 / Pixshop Developer REST API — image generation/editing, video, prompts, apps, community endpoints. Use when user wants to integrate Pixshop AI capabilities into their app via HTTP API, or call endpoints with curl/fetch.

Sourced from ClawHub, Authored by KLeo

Installation

Please help me install the skill `pixshop-creative-api` from SkillHub official store. npx skills add lizhijun/pixshop-creative-api

Pixshop Creative API — 开发者 REST 接口 / Developer REST API

Pixshop (pixshop.app) — AI 图片编辑 & 视频创意平台

通过 REST API 将 Pixshop 的 AI 创意能力集成到任何应用。覆盖图片生成（15+ 模型）、16 种图片编辑工具、视频生成、48+ AI 应用、提示词库、社区功能。所有接口统一返回 { success, data?, error? } 格式。

Setup / 配置

获取 Auth Token

# 方式 1：通过 CLI 登录获取 token
npm install -g pixshop
pixshop login
cat ~/.pixshop-config.json | jq '.accessToken'

# 方式 2：通过 Supabase Auth API
curl -X POST 'https://<supabase-url>/auth/v1/token?grant_type=password' 
  -H 'apikey: <anon-key>' 
  -d '{"email":"...","password":"..."}'

请求通用格式

curl -X POST https://pixshop.app/api/<endpoint> 
  -H "Authorization: Bearer <token>" 
  -H "Content-Type: application/json" 
  -d '{ ... }'

API 列表 (6 Groups, 30+ Endpoints)

1. AI 图片生成

POST /api/ai/generate — 文本生成图片

参数 类型 必需 说明
prompt string ✅ 图片描述
model string 模型名（默认 nano-banana）
aspectRatio string 1:1, 16:9, 9:16, 4:3, 3:4
quality string standard, hd
referenceImage string 参考图片 base64 或 URL
appId string Nano Banana App ID

示例:

curl -X POST https://pixshop.app/api/ai/generate 
  -H "Authorization: Bearer $TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"prompt":"a cute cat in space","aspectRatio":"1:1"}'

返回: { "success": true, "data": { "imageUrl": "...", "metadata": {...} } }

POST /api/ai/generate-video — 视频生成

参数 类型 必需 说明
imageUrl string ✅ 源图片 URL
prompt string 运动描述
model string 视频模型
duration string 时长 5/10/15 秒

POST /api/ai/adapt-parameters — 参数适配 (免费)

根据描述自动推荐最佳生成参数。

2. AI 图片编辑工具 (16 Tools)

所有工具统一格式：POST /api/tools/<tool-name>，需要 Auth Token。

POST /api/tools/face-swap — 人脸替换

参数 类型 必需 说明
targetImage string ✅ 目标图片（base64 或 URL）
sourceImage string ✅ 人脸来源图片
mode string swap (默认) 或 analyze

POST /api/tools/upscale — 超分辨率

参数 类型 必需 说明
image string ✅ 图片
scale number 2 或 4
modelType string general, portrait, anime, art

POST /api/tools/try-on — 虚拟试穿

参数 类型 必需 说明
personImage string ✅ 人物图片
garmentImage string ✅ 服装图片

POST /api/tools/makeup-studio/analyze — 妆容分析

参数 类型 必需 说明
image string ✅ 人脸图片

POST /api/tools/makeup-studio/apply — 妆容应用

参数 类型 必需 说明
image string ✅ 人脸图片
style string ✅ 妆容风格

POST /api/tools/aice-ps — AI 修图

参数 类型 必需 说明
image string ✅ 图片
action string ✅ retouch, filter, adjust, erase, beautify
prompt string 编辑指令

POST /api/tools/inpaint — 智能填充

参数 类型 必需 说明
image string ✅ 图片
mask string ✅ 遮罩区域
prompt string 填充内容

POST /api/tools/fashion-photoshoot — 时尚大片

参数 类型 必需 说明
image string ✅ 模特图片
style string 拍摄风格

POST /api/tools/id-photo — 证件照

参数 类型 必需 说明
image string ✅ 人像图片
background string 背景颜色
size string 尺寸预设

POST /api/tools/transform — 图片变换

参数 类型 必需 说明
image string ✅ 图片
prompt string ✅ 变换指令

POST /api/tools/sticker-set — 贴纸生成

参数 类型 必需 说明
prompt string ✅ 贴纸描述
style string 贴纸风格

POST /api/tools/pose-generate — 姿态生成

参数 类型 必需 说明
prompt string ✅ 姿态描述

POST /api/tools/angles — 多角度生成

参数 类型 必需 说明
image string ✅ 源图片

POST /api/tools/motion-control/generate — 运动控制

参数 类型 必需 说明
image string ✅ 源图片
prompt string 运动描述

3. Nano Banana Apps

GET /api/nano-banana/apps — 应用列表

参数 类型 必需 说明
category query 分类筛选
search query 搜索
featured query 精选应用 
curl https://pixshop.app/api/nano-banana/apps?category=generation

GET /api/nano-banana/apps/[id] — 应用详情

GET /api/nano-banana/apps/categories — 分类列表

GET /api/nano-banana/apps/featured — 精选应用

GET /api/nano-banana/apps/popular — 热门应用

4. 提示词库

GET /api/prompt-library — 提示词列表

参数 类型 必需 说明
search query 搜索关键词
category_id query 分类 ID
tags query 标签筛选
page query 页码
per_page query 每页数量 
curl "https://pixshop.app/api/prompt-library?search=cyberpunk&per_page=10"

GET /api/prompt-library/[id] — 提示词详情

POST /api/prompt-library/submit — 提交提示词（需登录）

GET /api/prompt-library/related?id=xxx — 相关推荐

5. 表情包生成

POST /api/meme — 表情包生成

参数 类型 必需 说明
image string ✅ 源图片
caption string 文字
style string 风格

6. Agent Skills

GET /api/agent/skills — 技能列表

返回所有可用 AI 技能及其参数定义。

POST /api/agent/skills/[id]/execute — 执行技能

参数 类型 必需 说明
... object ✅ 技能对应的输入参数 
curl -X POST https://pixshop.app/api/agent/skills/image-generate/execute 
  -H "Authorization: Bearer $TOKEN" 
  -d '{"prompt":"a sunset","aspectRatio":"16:9"}'

GET /api/agent/discover — 工具发现

浏览完整的 AI 工具目录。

统一响应格式

// 成功
{ "success": true, "data": { "imageUrl": "...", ... } }

// 失败
{ "success": false, "error": { "code": "AUTH_REQUIRED", "message": "..." } }

错误码: | 状态码 | 错误码 | 说明 | |--------|--------|------| | 401 | AUTH_REQUIRED | 未登录 | | 402 | INSUFFICIENT_CREDITS | 积分不足 | | 429 | RATE_LIMIT_EXCEEDED | 速率限制 | | 500 | INTERNAL_ERROR | 服务错误 |

典型工作流

开发者集成

获取 Token → GET /api/agent/discover 查看工具目录 → POST /api/ai/generate 生成图片 → POST /api/tools/upscale 超分放大

批量处理

GET /api/prompt-library → 获取提示词列表 → 循环调用 POST /api/ai/generate → 批量生成

电商场景

POST /api/tools/face-swap 换脸 → POST /api/tools/fashion-photoshoot 生成大片 → POST /api/tools/upscale 放大

注意事项

  • 认证：除 GET /api/nano-banana/apps 和 GET /api/prompt-library 外，所有写操作需 Bearer Token
  • 积分：AI 生成/编辑操作消耗积分，GET 查询免费
  • 速率限制：每个用户每分钟有请求上限，超出返回 429
  • 图片输入：支持 base64 data URL 或 HTTP URL
  • 异步操作：视频生成等长时间操作返回任务 ID，需轮询结果
  • CORS：API 支持跨域请求

在线体验

  • Pixshop 首页 — AI 创意平台全景
  • Nano Banana Apps — 48+ AI 应用市场
  • 提示词库 — 海量高质量提示词
  • Design Agent — AI 设计工作台
  • MCP 接口 — MCP 协议端点
  • 定价方案 — 免费 / 高级 / 企业

Powered by Pixshop — AI 图片编辑 & 视频创意平台