---
title: Seamless pattern API for AI agents | MakeSeamless
description: Let your AI agent check every pattern tile for seams before upload: one request, no key. Fixes keep the pixel size and pass the seam check, or cost nothing.
---

# Check and fix pattern seams from your agent or your code

MakeSeamless (makeseamless.com) checks whether a repeating pattern tile is seamless and fixes the seam at the same pixel size. The check is free and needs no account, every fix you download passes the seam check for the repeat you chose, and a fix with no passing result costs nothing. An agent can check each tile with no key before it is uploaded or printed.

Paste into a coding agent:

> Read https://makeseamless.com/llms.txt, then use the MakeSeamless API to check ./peony-pattern.png. Tell me which repeat types it passes and where any seam is.

## Check a tile in one request

Send the image as the form field `file`. No account and no key. The answer lists the repeat types the tile already passes in `satisfied`, and for each repeat type how strongly each edge breaks and where.

```bash
curl https://makeseamless.com/v1/check -F file=@peony-pattern.png
```

- `POST /v1/check`: a seam report for each repeat type. Free, no key.
- `POST /v1/fix`: starts a fix for one repeat type, with your API key. 1 credit, or 3 for a tile over 2048 px on either side.
- `GET /v1/jobs/{job_id}`: status, the seam report after the fix, and the PNG.

## How an agent should use MakeSeamless

The same five rules open the root llms.txt, so an agent that reads it first works the same way.

1. **Check first, before a tile is called seamless, uploaded or printed.** It is free and needs no key.
2. **Fix only when the repeat the user needs is not in `satisfied`,** and tell the user the cost first: 1 credit, or 3 for a tile over 2048 px on either side.
3. **Follow the job until it succeeds or fails,** waiting as long as Retry-After says.
4. **Report the numbers in the result's seam report.** A fix result already passed the seam check for its repeat.
5. **Never ask the user to paste an API key into a chat.** Read it from the environment, for example `MAKESEAMLESS_API_KEY`.

To make it a habit, paste this into your project's AGENTS.md or CLAUDE.md:

> Pattern tiles: before you call a pattern tile seamless, upload it to a print-on-demand shop or print it, check it with MakeSeamless: `POST https://makeseamless.com/v1/check` with the image as the multipart field `file`. It is free and needs no key. Fix a tile with `POST /v1/fix` only when the repeat type I need is not in `satisfied`, and tell me the cost first. Read the key from `MAKESEAMLESS_API_KEY`. Docs: https://makeseamless.com/docs/llms.txt

## Prompts to copy

Each prompt names makeseamless.com, so the agent goes straight to our API and docs.

- **Check one tile:** Using the MakeSeamless API (makeseamless.com), check ./peony-pattern.png and tell me which repeat types it passes.
- **Check a folder before upload:** Using the MakeSeamless API (makeseamless.com), check every PNG in ./etsy-papers as a straight repeat. Write the file name, verdict and broken edge of each to seam-report.csv.
- **Check what you just generated:** Using the MakeSeamless API (makeseamless.com), check each tile in ./out as a half-drop repeat before you call it seamless.
- **Fix the ones that fail:** Using the MakeSeamless API (makeseamless.com) and my key in MAKESEAMLESS_API_KEY, fix the tiles in ./etsy-papers that fail as straight, save each result as name-seamless.png, and tell me the credits used.

## What it costs

- Checks are free and unlimited, for people and agents alike.
- 1 credit = 1 fix. A tile over 2048 px on either side uses 3 credits, and you see the cost before the fix.
- A fix that ends without a passing result costs nothing, and the same fix of the same file returns the stored result at no charge.
- On the Free plan, fixes through the API carry a watermark.

| Plan | Price | Fixes |
| --- | --- | --- |
| Free | $0 | 1 free fix a day after sign-in |
| Pro | $19 a month | 50 credits a month |
| Pro | $49 a month | 135 credits a month |
| Pro | $99 a month | 280 credits a month |
| Pro | $149 a month | 430 credits a month |
| Enterprise | Custom | Credit volume set with you |

Yearly is 20% off. On Pro, top-ups cost $0.380, $0.363, $0.354 or $0.347 a credit, by tier. Plans and prices are also available as JSON at `/v1/plans`.

## Errors your agent can act on

Every error has a stable code and says whether retrying can help. When the account is short of credits, the error says how many the fix needs and when the next free daily fix is ready: `error.code`, `error.retryable`, `error.details.credits_needed`, `error.details.daily_free_resets_at`, `Retry-After`. Error reference: https://makeseamless.com/docs/errors.md

## Files for machines

- [/llms.txt](https://makeseamless.com/llms.txt): what MakeSeamless is and how an agent should use it, in one short file.
- [/v1/openapi.json](https://makeseamless.com/v1/openapi.json): the whole /v1 contract as one OpenAPI 3.1 file.
- [/agents.md](https://makeseamless.com/agents.md): every page as Markdown: add .md to its path, or ask for text/markdown.

## Questions

**Can my AI agent use MakeSeamless?** Yes. Any agent that can send a web request can check a tile with POST /v1/check, with no account or key. To fix, it uses an API key from your account and the same credits as the app. This guide has the steps and prompts to copy.

**Do fixes through an agent or the API cost more?** No. One credit is one fix wherever it starts, or 3 credits for a tile over 2048 px on either side. You see the cost before the fix, and a fix that fails costs nothing.

**What does MakeSeamless do to my tile?** It works on the tile you already made. It checks where the tile breaks when it repeats and fixes that seam. The width and height stay exactly the same, and outside the changed area every pixel is your original.