# SurgePix API (slim)

> SurgePix is a web design workspace that generates and edits images, posters and slide decks. A REST API with API keys, async tasks and file upload is called through MIT-licensed agent skills for coding agents.

- Full: https://www.anchorterminal.com/tools/surgepix.md (~7,950 tokens) · this version ~1,730 tokens · JSON https://www.anchorterminal.com/tools/surgepix.json · canonical https://www.anchorterminal.com/tools/surgepix
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-02 · pricing https://www.anchorterminal.com/tools/surgepix#pricing · reviews https://www.anchorterminal.com/tools/surgepix#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**F · 36/100 · rank #1173 of 1266 · #14 in Image generation · not agent-ready · confidence medium**


Assessment: A small, readable API with async tasks and MIT skill scripts that cover posters, decks, edits and translation. Only background removal is documented, the terms name no company and restrict commercial use and automated querying, and uploaded files become public URLs.

## Facts

- Kind: HTTP API · vendor: SurgePix · category: Image generation · legal entity: not named · provenance 41/100
- Endpoint: `https://api.surgepix.ai/api` (HTTP)
- Auth: API key · pricing: Freemium · x402: no · licence: Proprietary hosted service under the Surgepix User Agreement, which names no company and restricts commercial use without SurgePix's permission. The agent skills repository is MIT
- Probe metrics: not measured yet (probes haven't run)
- Surface: REST API at `https://api.surgepix.ai/api` with an async task model (`POST /tasks/<task>`, then `GET /tasks/{taskId}`, or `noWait: true` to wait). Sessions group iterations and show in the web app. No MCP server, SDK or OpenAPI file
- Documented endpoints: `/upload/chat-init`, `/upload/chunk`, `/upload/chat-complete`, `/tasks/remove-background`, `/tasks/{taskId}`
- Endpoints in the skills only: Main branch: `generate-presentation`, `generate-poster`, `generate-xhs-images`, `generate-illustrations`, `generate-logo`, `generate-storyboard`, `image-edit`, `generate-photo-poetic-editorial`, `generate-restaged-cinematic`, `image-translate`, `ppt-translate`. Dev branch: `add-logo`, `add-watermark`, `generate-brand-placement`, `generate-channel-crop-pack`. All under `/tasks/`
- Agent skills: 15 SKILL.md skills with Node scripts on the main branch (github.com/SurgePix/agent-skills, MIT), for Claude Code, Codex CLI, Cursor, Gemini CLI and OpenClaw. Installed with `npx skills add` or a clone. Named here, not graded as their own listing
- Uploads: Chunked, 5 MB parts recommended, with an MD5 that returns the existing URL for a file already uploaded. JPEG, PNG, WEBP and GIF images are checked for NSFW content. Files land on Tencent Cloud Object Storage (ap-seoul) as public URLs
- Outputs: One download URL per task, a ZIP for image sets. PNG for images (transparent for background removal), PPTX for presentations. Task status is kept for 24 hours
- Models: GPT Image 2 from 11 May 2026 and GPT-Image-2.5 from 23 October 2026, per the changelog. The free plan gets the full model line-up, per the pricing page
- Free tier: 25 credits a day, reset daily, about five image generations a day per the pricing page. Whether a card is needed, and whether a free account can create API keys, isn't stated
- Terms: Chinese law, courts where "Surgepix's limited company" is located, changes effective on publication without notice, no refunds once a membership is active. No company or address named
- Web app: Layer-based canvas with inpainting, text extraction into editable layers, a chat assistant with web search, templates and PPTX or PDF export. Not reachable through the API
- Prices: Basic plan, 2,000 credits $9.90 per month (plan); Pro plan, 11,500 credits $24.90 per month (plan)

- Scores: Reliability 15, Performance pending, Schema & documentation 40, Agent ergonomics 53, Security & auth 41, Payments & pricing 20, Task success pending, Maintenance & community 66, Transparency & trust 28 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines. · Schema & documentation, No OpenAPI or other machine-readable contract was found (0). · Agent ergonomics, Every task returns one download URL, or one ZIP for an image set, and status responses are a few fields, so little enters context (18). · Security & auth, Plain API keys created in the account settings, which the docs say can be revoked and reset. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, The last dated change is GPT-Image-2.5 on 23 October 2026, 10 days before the check (30). · Transparency & trust, The editorial half.
- Sources: 13, open questions: 7, both in the full twin
- Capabilities: image.generate, image.edit
- JSON: https://www.anchorterminal.com/api/v1/tools/surgepix.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/surgepix.svg` or a link to https://www.anchorterminal.com/tools/surgepix from a page on surgepix.ai or one of its subdomains, or the README at the root of github.com/SurgePix/agent-skills, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: Discord https://discord.gg/wC5XeHN6fR; contact@tate-a-tate.com; https://surgepix.ai/blog; https://surgepix.ai/blog/developer-guides/call-skills; more in the full twin

## Before you call it

1. Send the key as the raw `authorization` header value, with no `Bearer` prefix
2. Don't upload confidential files. The upload flow returns a public URL for every file
3. Check `code` in the JSON body as well as the HTTP status, since failures come back as a non-zero `code` with a `msg`
4. Poll `GET /tasks/{taskId}` within 24 hours, after which the task returns 404
5. Get written permission before using outputs commercially, since the terms restrict commercial use

## Connect

```bash
npx skills add SurgePix/agent-skills
```

```bash
curl --request POST \
  --url https://api.surgepix.ai/api/tasks/remove-background \
  --header 'authorization: sk-YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"fileUrl": "<URL from the upload flow>", "noWait": true}'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/surgepix

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| fal image models | BB | 70.7 | image.generate, image.edit | https://www.anchorterminal.com/tools/fal-image.min.md |
| OpenAI Image API | B | 69.5 | image.generate, image.edit | https://www.anchorterminal.com/tools/openai-image-api.min.md |
| Bria API | B | 67.5 | image.generate, image.edit | https://www.anchorterminal.com/tools/bria.min.md |
| Canva REST APIs + MCP | B | 67.3 | image.generate, image.edit | https://www.anchorterminal.com/tools/canva.min.md |
| Black Forest Labs FLUX API | B | 66.3 | image.generate, image.edit | https://www.anchorterminal.com/tools/black-forest-labs.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)