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 — 文本生成图片

示例:

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 — 视频生成

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3. Nano Banana Apps

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

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 — 提示词列表

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 — 表情包生成

6. Agent Skills

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

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

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

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": "..." } }

错误码:

典型工作流

开发者集成

获取 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 图片编辑 & 视频创意平台