Pixshop Creative API — Developer REST Endpoints

Pixshop 开发者 REST API — 图片生成/编辑、视频制作、提示词库、应用市场、社区 / Pixshop Developer REST API — image generation/editing, video, prompts, apps, community endpoints. Use when...

Security Scan

The skill appears to be a straightforward Pixshop REST API reference, but the runtime instructions encourage reading local config/credentials and show auth flows while the skill declares no required credentials — this mismatch warrants caution.

Purpose & Capability

The name/description match the SKILL.md content (REST endpoints for Pixshop). However, the instructions demonstrate auth acquisition (CLI login and reading ~/.pixshop-config.json, Supabase auth examples) even though the skill declares no required environment variables or primary credential. A REST-integration skill would normally declare a token env var (e.g., PIXSHOP_TOKEN).

Instruction Scope

SKILL.md contains explicit examples that read local configuration (cat ~/.pixshop-config.json) and install/run a 'pixshop' CLI. The skill header allows Bash and Read tools, which combined with those examples means the agent could be instructed to access local files/execute shell commands to obtain tokens. That expands scope beyond merely describing HTTP endpoints and could lead to unintended credential exposure.

Install Mechanism

This is instruction-only (no install spec, no code files). That is low-risk from an installation-perspective because nothing is downloaded or written by the skill itself.

Credentials

The API clearly requires an Authorization Bearer token, and examples reference an accessToken and Supabase apikey, but the skill declares no required env vars or primary credential. The absence of declared credentials is disproportionate to the documented auth needs and makes it unclear how the agent should obtain/store tokens safely.

Persistence & Privilege

always is false (normal). The skill allows Bash and Read in its header, enabling runtime shell and file reads; this is not inherently malicious but increases the blast radius if the agent is allowed to execute autonomously. No evidence the skill requests permanent presence or modifies other skills.

What to consider before installing

This skill is largely a documentation page for Pixshop's REST endpoints, but it demonstrates ways to obtain tokens (installing a CLI and reading ~/.pixshop-config.json) without declaring required credentials. Before installing or enabling it: - Verify the skill's source or official Pixshop docs (no homepage/source provided here). - Prefer providing an explicit PIXSHOP_TOKEN environment variable rather than letting the agent run shell commands or read ~/.pixshop-config.json. - If you do not want the agent to access local files or run commands, remove or restrict allowed-tools (Bash/Read) or disable autonomous invocation for this skill. - If you consider installing the 'pixshop' npm CLI, review that package and its maintainers first (npm install -g runs code). - Be cautious with the Supabase examples: they reference apikeys and auth endpoints — never expose service anon/secret keys unless you intend to. If you want a low-risk integration, ask the skill author to declare required env vars (token) and remove instructions that encourage reading local config files or installing third-party CLIs.

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