| tags |
|
||||||||
|---|---|---|---|---|---|---|---|---|---|
| tools |
|
||||||||
| companies |
|
||||||||
| dependencies |
|
Agent skills for hosting images, MP4 videos, and MP3/WAV/M4A/OGG audio, creating social-ready video copies, running resumable video transcript/storyboard enrichment, and transcribing audio to text/WebVTT/timestamped JSON.
PixelVault is agent-first media hosting for developers and AI coding agents. These skills let an agent upload screenshots, diagrams, mockups, generated images, MP4 videos, and audio; get instant globally cached original URLs, plus optional transcript artifacts, without a manual dashboard.
When it triggers: "screenshot this and host it", "upload this image and give me the URL", "host this MP4", "give me a URL for this audio", "transcribe this podcast", "make captions for this audio", or any task needing hosted media.
- Just an API key — no crypto wallet, no per-upload payment. A permanent free tier, not a trial.
- Permanent, global URLs — served from Cloudflare's edge CDN with zero egress fees.
- Built for discovery — ships a Claude Code skill, a remote MCP server,
llms.txt, and an OpenAPI 3.1 spec so any agent can find and call it. - Works with any agent — Claude Code, Codex, Cursor, Gemini CLI, or paste
SKILL.mdinto custom instructions.
| Skill | Description |
|---|---|
/pixelvault-upload <file-or-url> |
Upload images or video, or host/transcribe MP3/WAV/M4A/OGG audio; get public/signed CDN URLs; manage lifecycle; or run video optimization/enrichment |
/pixelvault-host-image |
Zero-install: host a file or URL with one curl, no signup (keyless, 30-day links; add a key for permanent). Published on ClawHub for OpenClaw |
/pixelvault-setup |
Install CLI and configure API key |
/pixelvault-list |
List recently uploaded images, search them by AI description or tag, and describe an already-uploaded image (alt text, OCR, tags; needs pixelvault-cli 0.13.0+ for tags/describe) |
/pixelvault-optimize |
Compress and resize local images (no account needed): pixelvault optimize |
/pixelvault-transform |
Resize, convert, remove backgrounds, add effects or a watermark — via URL params |
/pixelvault-ecommerce-catalog <folder or URLs> |
Turn product photos into catalog variants (marketplace white squares, listing/PDP sizes, thumbnails, cut-outs, watermarks) and verify each one before reporting URLs |
/pixelvault-generate <prompt> |
Generate an image from a prompt and host it. Built-in by default (pixelvault generate, only your PixelVault key, monthly credits); OpenRouter for other models |
/pixelvault-email-images |
Host the local images in an email template (Resend, react-email) and rewrite them to permanent CDN URLs |
/pixelvault-desktop |
Get a local screenshot/clipboard image into a remote/cloud agent as a URL (via the PixelVault desktop app) |
/pixelvault-account |
Check quota/usage before bulk uploads; list, create, rotate, and revoke API keys; start a plan upgrade or open the billing portal (needs pixelvault-cli 0.6.0+, 0.7.0+ for upgrade/billing) |
npx skills add pixelvault-dev/skillThen, inside your agent:
- Run
/pixelvault-setupto configure your API key - Upload media with
/pixelvault-upload screenshot.png,/pixelvault-upload demo.mp4,/pixelvault-upload episode.ogg, or a public media URL. Ask it to manage or transcribe anaud_...asset, or enrich a local MP4/existingvid_...asset.
- skills.sh (any agent) —
npx skills add pixelvault-dev/skillinstalls the skill folders for Claude Code, Codex, Cursor, and more. - Claude Code plugin — install from the marketplace, or copy the folders in
skills/into.claude/skills/(project) or~/.claude/skills/(user). - OpenClaw —
openclaw skills install pixelvault-host-image(from ClawHub). Needs onlycurl. Guide: https://pixelvault.dev/integrations/openclaw - Remote MCP server — point any MCP-capable agent at
https://mcp.pixelvault.dev/mcp(bearer auth with your API key). No local install required. - Any other agent — paste a
SKILL.mdfromskills/into your custom instructions, or hand the agent the OpenAPI spec below.
The skill wraps the PixelVault CLI. When you or an agent uploads media:
- A local file is read by the CLI, or PixelVault securely imports a public media URL.
- It is stored on Cloudflare R2 and served globally through Cloudflare CDN.
- You get a URL such as
https://img.pixelvault.dev/proj_abc/img_xyz.png,https://img.pixelvault.dev/proj_abc/vid_xyz.mp4, orhttps://img.pixelvault.dev/proj_abc/aud_xyz.ogg. - For social publishing, the agent can create a separate H.264/AAC fast-start copy without changing the original (up to 100 MB and 60 seconds).
- For transcript/storyboard enrichment, the agent exposes the asset and job IDs immediately, waits with a bounded timeout, and can resume later without another upload.
- Node.js 20+
- A PixelVault account. Free tier: 200 MB storage, 500 uploads/month, 1 GB bandwidth, 5 MB per image, and 25 MB per MP4 video. No credit card or trial expiry.
- Audio originals have an approved global maximum of 25,000,000 bytes. This is a byte ceiling, not a plan allowance or reserved capacity.
- Audio enrichment accepts up to 10 minutes and shares the existing media-enrichment allowance with video.
> /pixelvault-upload screenshot.png
Uploaded: https://img.pixelvault.dev/proj_abc/img_xyz.png
> /pixelvault-upload *.png --folder diagrams
Uploaded: https://img.pixelvault.dev/proj_abc/img_001.png
Uploaded: https://img.pixelvault.dev/proj_abc/img_002.png
> /pixelvault-upload demo.mp4
Uploaded: https://img.pixelvault.dev/proj_abc/vid_xyz.mp4
> /pixelvault-upload https://media.example.com/demo.mp4
Uploaded: https://img.pixelvault.dev/proj_abc/vid_xyz.mp4
> /pixelvault-upload episode.ogg
Uploaded: https://img.pixelvault.dev/proj_abc/aud_xyz.ogg
> Make that uploaded video social-ready
Optimized: https://img.pixelvault.dev/proj_abc/vid_xyz.social.mp4
> Enrich that video and return its transcript and storyboard; don't wait forever
Enrichment queued: asset vid_xyz, job ven_xyz
Completed: original MP4 + text/VTT/JSON transcript + storyboard index/sheets
> Transcribe that podcast; return captions and save IDs so I can resume
Enrichment queued: asset aud_xyz, job aen_xyz
Completed: original audio + text/VTT/timestamped JSON transcript
> /pixelvault-list --json
[{ "id": "img_xyz", "url": "https://...", "size": 45200, ... }]
PixelVault is designed to be found and used by agents without a human in the loop:
- MCP server —
https://mcp.pixelvault.dev/mcp - llms.txt — pixelvault.dev/llms.txt
- OpenAPI 3.1 spec — api.pixelvault.dev/openapi.json
- API catalog (RFC 9727) — pixelvault.dev/.well-known/api-catalog
- PixelVault — Landing page
- API Docs — Full API reference
- CLI — CLI on npm
- JavaScript/TypeScript SDK and Python SDK — for code that calls the API directly
- OpenAPI Spec — Machine-readable API spec
MIT