Pixshop Creative API — Developer REST Endpoints

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.

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