Getting started
Agent skill
One file that teaches an AI agent how to use the PrintResize API. Ask for a print file in plain words; the agent picks the tool, checks the price, asks you before spending credits, and downloads the result.
What the agent does
The skill is a SKILL.md file: written instructions plus the request formats for all nine tools. With it installed, an agent follows the same steps every time:
- Runs a free price check (
dryRun=true) with your real image and tells you the cost and your balance. - Waits for your yes before it submits, unless you already gave it a spending limit that covers the run.
- Sends a
clientRequestIdwith each run, so a retry after a timeout returns the same task instead of charging twice. - Polls until the task finishes, saves the file, and reports the size in pixels and the credits spent, plus the DPI for Print Resize.
It reads your key from an environment variable and never asks you to paste it into the chat.
Install
The quickest way is the skills CLI, which installs for Claude Code and other agents that read SKILL.md files. In Claude Code you can also add it as a plugin.
To install by hand, download SKILL.md into a folder named printresize in your agent’s skills directory. For Claude Code that’s ~/.claude/skills/, or .claude/skills/ inside one repository.
The source is on GitHub. Install again when you want the latest version.
npx skills add ivanvolt-labs/printresize-skillclaude plugin marketplace add ivanvolt-labs/printresize-skill
claude plugin install printresize@printresizemkdir -p ~/.claude/skills/printresize
curl -fsSL https://printresize.com/skills/printresize/SKILL.md \
-o ~/.claude/skills/printresize/SKILL.mdSet your API key
Create a key on the API keys page and set it as PRINTRESIZE_API_KEY in the shell your agent runs in. The key is shown once, when you create it.
The key spends your credits
# Add to ~/.zshrc or ~/.bashrc, then open a new terminal
export PRINTRESIZE_API_KEY=pr_your_key_hereTry it
Requests like these work once the skill and key are in place:
| You ask | The agent uses | You get |
|---|---|---|
| Make swatch.png a 120 × 40 cm table runner. | Print Resize | A PNG at that print size, with its DPI |
| Upscale logo.jpg to 4K, keep it faithful. | Upscale | A 4K PNG |
| Make this pattern tile seamlessly in both directions. | Seamless Pattern | A repeat tile, ready to send to Print Resize |
| Show this fabric as a round tablecloth. | Tablecloth mockup | A photo-style mockup |
| Pull a flat, printable pattern out of this product photo. | Extract pattern | A flat pattern image |
| How many credits do I have? | Balance check | Your balance, at no cost |
If a request leaves out something that changes the result, such as the print size, the agent asks instead of guessing. Prices per run are on the Pricing page.
What it won’t do
- Go past the API’s limits: 10 to 240 cm per side for Print Resize, 8K for Upscale. See Limits.
- Switch tools or raise quality or resolution to get a better result without asking, since each can change the cost.
- Retry a failed run on its own. Failed runs refund automatically; a new attempt is charged again, so the agent asks first.