> ## Documentation Index > Fetch the complete documentation index at: https://makeseamless.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > MakeSeamless (makeseamless.com) checks whether a repeating pattern tile is seamless and fixes the seam at the same pixel size. Use it when a user needs a tile to repeat without a visible line: before a pattern is uploaded to a print-on-demand shop or printed, after a tile is made, resized or exported, or when a proof shows a line where the pattern repeats. > Check first: POST https://makeseamless.com/v1/check with the image as the multipart field file. It is free and needs no account and no key. The repeat types the tile passes are in satisfied; report them before calling a tile seamless. > Fix only a repeat type the user needs that is not in satisfied, and tell the user the cost first (GET /v1/plans, fix_credits). POST /v1/fix needs an API key in the x-api-key header. Keys begin with smls_; read the key from the environment, never ask for it in a chat. > POST /v1/fix answers 202 with a job. Poll GET /v1/jobs/{job_id}, waiting the seconds in Retry-After, until status is succeeded or failed. The fixed PNG is at result.image_url. Answers are JSON, except the images, which are PNG. > A fixed tile has passed the seam check for its repeat type, keeps the exact width and height, and is the original outside the changed area (result.changed_mask_url). A fix with no passing result fails with no_seamless_candidate and costs nothing. > Branch on error.code, never on error.message, and retry only when error.retryable is true. # Start a fix that makes a pattern tile repeat seamlessly > Validates the image, then starts a job in the background that makes it tile seamlessly under the requested repeat type, and answers `202` with the job. Poll `GET /v1/jobs/{job_id}`. Inputs: PNG, JPEG or WebP, at most 40 MB, at least 64 x 64 px, at most 3600 px on a side; an even height for `half_drop` and an even width for `half_brick`; no transparent pixels near the edges. A fix costs one credit, or `Plans.fix_credits.large_credits` for a tile above `large_above_px` on either side, paid from the account's credits. The credits are reserved when the job starts and come back when it fails, whatever its error code. The same image with the same repeat type, fixed before, gets a job that has already `succeeded`, marked `cached`, at no charge. Sent again while its fix is still `queued` or `running`, it gets that same job back, at no charge. ```js Node.js theme={"theme":{"light":"github-light","dark":"vesper"}} import { readFile } from "node:fs/promises"; const form = new FormData(); form.append("file", new Blob([await readFile("tile.png")]), "tile.png"); form.append("repeat", "straight"); const response = await fetch("https://makeseamless.com/v1/fix", { method: "POST", headers: { "x-api-key": "smls_your_api_key" }, body: form, }); const data = await response.json(); console.log(data); ``` ```php PHP theme={"theme":{"light":"github-light","dark":"vesper"}} new CURLFile("tile.png"), "repeat" => "straight", ]); $response = curl_exec($ch); curl_close($ch); echo $response; ``` ```python Python theme={"theme":{"light":"github-light","dark":"vesper"}} import requests with open("tile.png", "rb") as file: response = requests.post( "https://makeseamless.com/v1/fix", headers={"x-api-key": "smls_your_api_key"}, files={"file": file}, data={"repeat": "straight"}, ) response.raise_for_status() print(response.json()) ``` ```ruby Ruby theme={"theme":{"light":"github-light","dark":"vesper"}} require "net/http" require "uri" uri = URI("https://makeseamless.com/v1/fix") request = Net::HTTP::Post.new(uri) request["x-api-key"] = "smls_your_api_key" request.set_form( [ ["file", File.open("tile.png")], ["repeat", "straight"], ], "multipart/form-data", ) response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http| http.request(request) end puts response.body ``` ```go Go theme={"theme":{"light":"github-light","dark":"vesper"}} package main import ( "bytes" "fmt" "io" "mime/multipart" "net/http" "os" ) func main() { var payload bytes.Buffer form := multipart.NewWriter(&payload) file, err := os.Open("tile.png") if err != nil { panic(err) } defer file.Close() part, err := form.CreateFormFile("file", "tile.png") if err != nil { panic(err) } if _, err := io.Copy(part, file); err != nil { panic(err) } form.WriteField("repeat", "straight") form.Close() req, err := http.NewRequest("POST", "https://makeseamless.com/v1/fix", &payload) if err != nil { panic(err) } req.Header.Set("x-api-key", "smls_your_api_key") req.Header.Set("Content-Type", form.FormDataContentType()) res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ```java Java theme={"theme":{"light":"github-light","dark":"vesper"}} import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.nio.charset.StandardCharsets; import java.nio.file.Files; import java.nio.file.Path; import java.util.ArrayList; import java.util.List; String boundary = "makeseamless-form"; List parts = new ArrayList<>(); parts.add(("--" + boundary + "\r\n" + "Content-Disposition: form-data; name=\"file\"; filename=\"tile.png\"\r\n\r\n") .getBytes(StandardCharsets.UTF_8)); parts.add(Files.readAllBytes(Path.of("tile.png"))); parts.add("\r\n".getBytes(StandardCharsets.UTF_8)); parts.add(("--" + boundary + "\r\n" + "Content-Disposition: form-data; name=\"repeat\"\r\n\r\n" + "straight\r\n").getBytes(StandardCharsets.UTF_8)); parts.add(("--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8)); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://makeseamless.com/v1/fix")) .header("x-api-key", "smls_your_api_key") .header("Content-Type", "multipart/form-data; boundary=" + boundary) .POST(HttpRequest.BodyPublishers.ofByteArrays(parts)) .build(); HttpResponse response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); ``` ```csharp .NET theme={"theme":{"light":"github-light","dark":"vesper"}} using System.Net.Http; var request = new HttpRequestMessage(HttpMethod.Post, "https://makeseamless.com/v1/fix"); request.Headers.Add("x-api-key", "smls_your_api_key"); var form = new MultipartFormDataContent(); form.Add(new ByteArrayContent(File.ReadAllBytes("tile.png")), "file", "tile.png"); form.Add(new StringContent("straight"), "repeat"); request.Content = form; var client = new HttpClient(); var response = await client.SendAsync(request); Console.WriteLine(await response.Content.ReadAsStringAsync()); ``` ```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}} curl -X POST "https://makeseamless.com/v1/fix" \ -H "x-api-key: smls_your_api_key" \ -F "file=@tile.png" \ -F "repeat=straight" ``` ```json Response theme={"theme":{"light":"github-light","dark":"vesper"}} { "id": "job_2432c1827f32450f800694e552e9915c", "status": "queued", "stage": "queued", "repeat": "straight", "cached": false, "input": { "sha256": "9cf95d486b4c7d1bd6022a3e51d7c89b89ba5239d0378033c9a9f53413dd7770", "width": 256, "height": 256, "format": "PNG", "has_alpha": true }, "created_at": "2026-11-03T15:24:08.435Z", "started_at": null, "finished_at": null, "result": null, "error": null, "candidates": [] } ``` ## OpenAPI ````yaml openapi.json POST /v1/fix openapi: 3.1.0 info: title: MakeSeamless API version: 1.0.0 summary: Check whether an image tiles seamlessly, and make it tile seamlessly. description: > Check a pattern tile for seams where its copies meet, and fix it so that it repeats without a visible seam. - A check is free and needs no account. A fix needs an API key and costs credits (`GET /v1/plans`). - A fix runs in the background: `POST /v1/fix` answers `202` with a job. Poll `GET /v1/jobs/{job_id}` until its `status` is `succeeded` or `failed`, waiting the seconds that `Retry-After` gives. - Every image the API returns has the exact width and height of the uploaded image (after its orientation is applied), as a fresh lossless PNG that carries no metadata of the upload. - Breaking changes come only under a new prefix (`/v2`). Fields may be added to responses; ignore the fields you do not know. - Error codes are stable: read `error.code`, not `error.message`. Any request may also fail with `500` and the code `internal_error`. license: name: Proprietary servers: - url: https://makeseamless.com security: [] tags: - name: check description: Seam check, answered at once. - name: fix description: Fix job, run in the background. - name: jobs description: Job status, result images and ratings. - name: health description: Service status. - name: account description: The account, its plan and credits. paths: /v1/fix: post: tags: - fix summary: Start a fix description: > Validates the image, then starts a job in the background that makes it tile seamlessly under the requested repeat type, and answers `202` with the job. Poll `GET /v1/jobs/{job_id}`. Inputs: PNG, JPEG or WebP, at most 40 MB, at least 64 x 64 px, at most 3600 px on a side; an even height for `half_drop` and an even width for `half_brick`; no transparent pixels near the edges. A fix costs one credit, or `Plans.fix_credits.large_credits` for a tile above `large_above_px` on either side, paid from the account's credits. The credits are reserved when the job starts and come back when it fails, whatever its error code. The same image with the same repeat type, fixed before, gets a job that has already `succeeded`, marked `cached`, at no charge. Sent again while its fix is still `queued` or `running`, it gets that same job back, at no charge. operationId: createFixJob requestBody: required: true content: multipart/form-data: schema: type: object required: - file - repeat properties: file: type: string format: binary description: The image file (PNG, JPEG or WebP). repeat: $ref: '#/components/schemas/RepeatType' responses: '202': description: The job, `queued`, or already `succeeded` when `cached`. headers: Location: $ref: '#/components/headers/Location' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/Job' example: id: job_2432c1827f32450f800694e552e9915c status: queued stage: queued repeat: straight cached: false input: sha256: >- 9cf95d486b4c7d1bd6022a3e51d7c89b89ba5239d0378033c9a9f53413dd7770 width: 256 height: 256 format: PNG has_alpha: true created_at: '2026-11-03T15:24:08.435Z' started_at: null finished_at: null result: null error: null candidates: [] '401': $ref: '#/components/responses/AuthRequired' '402': description: > Not enough credits for the fix (`insufficient_credits`); `details.credits_needed` is what it costs. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: insufficient_credits message: Not enough credits for this fix. retryable: false details: credits_needed: 1 '413': $ref: '#/components/responses/PayloadTooLarge' '422': $ref: '#/components/responses/InvalidInput' '429': description: > Not now; `Retry-After` says when to try again. `daily_capacity_reached`: the service's fixes for the day are at capacity. `too_many_running_fixes`: the account already has 3 fixes queued or running. headers: Retry-After: $ref: '#/components/headers/RetryAfterLimit' content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] x-codeSamples: - lang: js label: Node.js source: >- import { readFile } from "node:fs/promises"; const form = new FormData(); form.append("file", new Blob([await readFile("tile.png")]), "tile.png"); form.append("repeat", "straight"); const response = await fetch("https://makeseamless.com/v1/fix", { method: "POST", headers: { "x-api-key": "smls_your_api_key" }, body: form, }); const data = await response.json(); console.log(data); - lang: php label: PHP source: |- new CURLFile("tile.png"), "repeat" => "straight", ]); $response = curl_exec($ch); curl_close($ch); echo $response; - lang: python label: Python source: |- import requests with open("tile.png", "rb") as file: response = requests.post( "https://makeseamless.com/v1/fix", headers={"x-api-key": "smls_your_api_key"}, files={"file": file}, data={"repeat": "straight"}, ) response.raise_for_status() print(response.json()) - lang: ruby label: Ruby source: >- require "net/http" require "uri" uri = URI("https://makeseamless.com/v1/fix") request = Net::HTTP::Post.new(uri) request["x-api-key"] = "smls_your_api_key" request.set_form( [ ["file", File.open("tile.png")], ["repeat", "straight"], ], "multipart/form-data", ) response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http| http.request(request) end puts response.body - lang: go label: Go source: "package main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"mime/multipart\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tvar payload bytes.Buffer\n\tform := multipart.NewWriter(&payload)\n\tfile, err := os.Open(\"tile.png\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer file.Close()\n\tpart, err := form.CreateFormFile(\"file\", \"tile.png\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tif _, err := io.Copy(part, file); err != nil {\n\t\tpanic(err)\n\t}\n\tform.WriteField(\"repeat\", \"straight\")\n\tform.Close()\n\n\treq, err := http.NewRequest(\"POST\", \"https://makeseamless.com/v1/fix\", &payload)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"x-api-key\", \"smls_your_api_key\")\n\treq.Header.Set(\"Content-Type\", form.FormDataContentType())\n\n\tres, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\n\tbody, _ := io.ReadAll(res.Body)\n\tfmt.Println(string(body))\n}" - lang: java label: Java source: >- import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.nio.charset.StandardCharsets; import java.nio.file.Files; import java.nio.file.Path; import java.util.ArrayList; import java.util.List; String boundary = "makeseamless-form"; List parts = new ArrayList<>(); parts.add(("--" + boundary + "\r\n" + "Content-Disposition: form-data; name=\"file\"; filename=\"tile.png\"\r\n\r\n") .getBytes(StandardCharsets.UTF_8)); parts.add(Files.readAllBytes(Path.of("tile.png"))); parts.add("\r\n".getBytes(StandardCharsets.UTF_8)); parts.add(("--" + boundary + "\r\n" + "Content-Disposition: form-data; name=\"repeat\"\r\n\r\n" + "straight\r\n").getBytes(StandardCharsets.UTF_8)); parts.add(("--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8)); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://makeseamless.com/v1/fix")) .header("x-api-key", "smls_your_api_key") .header("Content-Type", "multipart/form-data; boundary=" + boundary) .POST(HttpRequest.BodyPublishers.ofByteArrays(parts)) .build(); HttpResponse response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); - lang: csharp label: .NET source: >- using System.Net.Http; var request = new HttpRequestMessage(HttpMethod.Post, "https://makeseamless.com/v1/fix"); request.Headers.Add("x-api-key", "smls_your_api_key"); var form = new MultipartFormDataContent(); form.Add(new ByteArrayContent(File.ReadAllBytes("tile.png")), "file", "tile.png"); form.Add(new StringContent("straight"), "repeat"); request.Content = form; var client = new HttpClient(); var response = await client.SendAsync(request); Console.WriteLine(await response.Content.ReadAsStringAsync()); - lang: bash label: cURL source: |- curl -X POST "https://makeseamless.com/v1/fix" \ -H "x-api-key: smls_your_api_key" \ -F "file=@tile.png" \ -F "repeat=straight" components: schemas: RepeatType: type: string enum: - straight - half_drop - half_brick description: > `straight`: plain repeat on both axes. `half_drop`: the next column is shifted down by half the height (needs an even height). `half_brick`: the next row is shifted right by half the width (needs an even width). Job: type: object required: - id - status - stage - repeat - cached - input - created_at - started_at - finished_at - result - error - candidates properties: id: type: string pattern: ^job_[0-9a-f]{32}$ status: $ref: '#/components/schemas/JobStatus' stage: $ref: '#/components/schemas/JobStage' repeat: $ref: '#/components/schemas/RepeatType' cached: type: boolean description: >- True when the same image was fixed before and this result was served again, at no charge. input: $ref: '#/components/schemas/InputInfo' created_at: type: string format: date-time started_at: type: - string - 'null' format: date-time finished_at: type: - string - 'null' format: date-time result: oneOf: - $ref: '#/components/schemas/FixResult' - type: 'null' description: Present when `status` is `succeeded`. error: oneOf: - $ref: '#/components/schemas/ErrorBody' - type: 'null' description: Present when `status` is `failed`. candidates: type: array description: > The other images of a succeeded job, `candidate_a` (the `result.alternative`) first. Empty until the job succeeded, and for a failed job. items: $ref: '#/components/schemas/Candidate' Error: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' JobStatus: type: string enum: - queued - running - succeeded - failed JobStage: type: string enum: - queued - fixing - finishing - finished description: > Progress for display; it only moves forward. `queued`: waiting to start. `fixing`: seamless versions of the image are being made. `finishing`: the result and its files are being prepared. `finished`: the job succeeded or failed. InputInfo: type: object required: - sha256 - width - height - format - has_alpha properties: sha256: type: string pattern: ^[0-9a-f]{64}$ description: SHA-256 of the uploaded file bytes. width: type: integer minimum: 64 description: Width in px, after the image's orientation is applied. height: type: integer minimum: 64 description: Height in px, after the image's orientation is applied. format: type: string enum: - PNG - JPEG - WEBP has_alpha: type: boolean FixResult: type: object required: - outcome - image_url - changed_mask_url - width - height - sha256 - resampled - changed_share - seam_report - alternative properties: outcome: $ref: '#/components/schemas/Outcome' image_url: type: string description: '`/v1/jobs/{job_id}/result`.' changed_mask_url: type: string description: '`/v1/jobs/{job_id}/changed_mask`, the changed area.' visible_changed_mask_url: type: string description: > `/v1/jobs/{job_id}/visible_mask`, the visibly changed area. Absent on results made before it was offered. width: type: integer description: Always the uploaded image's width. height: type: integer description: Always the uploaded image's height. sha256: type: string pattern: ^[0-9a-f]{64}$ description: SHA-256 of the result PNG bytes. resampled: type: boolean description: >- True when every pixel changed (outcome `resampled`); fine detail may look a little softer. changed_share: type: number minimum: 0 maximum: 1 description: > Share of the image inside the changed area (the white share of `changed_mask_url`): the band along the edges, or 1 when every pixel changed. visible_changed_share: type: number minimum: 0 maximum: 1 description: > Share of the image that looks different from the upload (the white share of `visible_changed_mask_url`), never more than `changed_share`. When every pixel changed but most only slightly, `changed_share` is 1 and this share is much smaller. Absent on results made before it was offered. seam_report: $ref: '#/components/schemas/SeamReport' alternative: oneOf: - $ref: '#/components/schemas/Alternative' - type: 'null' description: Null when the fix made no other image. ErrorBody: type: object required: - code - message - retryable properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string description: Plain-language explanation; it may change, do not parse it. retryable: type: boolean description: >- True when the same request can succeed later (a new fix, or polling again). details: type: object description: 'Optional machine-readable context, for example `{"max_side": 3600}`.' Candidate: type: object required: - id - image_url - passed - changed_share - resampled description: An image the fix made besides the result. properties: id: $ref: '#/components/schemas/CandidateId' image_url: type: string description: '`/v1/jobs/{job_id}/candidates/{id}`.' passed: type: boolean description: True when it passed the same checks as a result. changed_share: type: number minimum: 0 maximum: 1 description: Share of the image inside its changed area. resampled: type: boolean description: >- True when every pixel changed (outcome `resampled`); fine detail may look a little softer. Outcome: type: string enum: - ok - resampled description: > `ok`: the result passed the seam check and the quality checks that apply to the image. `resampled`: no version passed every quality check, so the result is one in which every pixel changed; it passes the seam check, and fine detail may look a little softer. SeamReport: type: object required: - before - after description: >- The seam report for the requested repeat type, on the upload and on the result. properties: before: $ref: '#/components/schemas/RepeatVerdict' after: $ref: '#/components/schemas/RepeatVerdict' Alternative: type: object required: - id - image_url - passed - changed_share description: The other candidate shown next to the result. properties: id: $ref: '#/components/schemas/CandidateId' image_url: type: string description: '`/v1/jobs/{job_id}/candidates/{id}`.' passed: type: boolean description: >- True when it passed the same checks as a result. Offer its download only when true. changed_share: type: number minimum: 0 maximum: 1 description: Share of the image inside its changed area. ErrorCode: type: string enum: - validation_error - payload_too_large - unsupported_format - decode_failed - too_small - too_large - odd_dimension - transparent_seam_band - not_found - result_not_ready - no_result - no_seamless_candidate - service_unavailable - interrupted - internal_error - auth_required - insufficient_credits - daily_capacity_reached - too_many_running_fixes - rate_limited - already_subscribed - pro_required - no_subscription - rating_closed - already_reported - account_deleted - plan_managed_elsewhere - purchase_owned_elsewhere - invalid_purchase description: > Stable codes. Of a failed job: `no_seamless_candidate` (no version of the image tiled seamlessly; in the rare case that the image does not read as a repeating pattern tile at all, `details.pattern_tile` is false), `service_unavailable` (the fix could not run for now; try again later), `interrupted` (the service stopped while the job ran; start the fix again) and `internal_error`. CandidateId: type: string pattern: ^candidate_[a-z]+$ description: > The id of an image of the job other than the result: `candidate_a`, `candidate_b` and so on. Ids are per job. RepeatVerdict: type: object required: - repeat - verdict - edges description: The verdict for one repeat type, with its seam report per edge. properties: repeat: $ref: '#/components/schemas/RepeatType' verdict: $ref: '#/components/schemas/Verdict' edges: type: array description: Empty when the verdict is `not_applicable`. items: $ref: '#/components/schemas/EdgeReport' Verdict: type: string enum: - ok - minor - bad - not_applicable description: >- `ok`: no seam. `minor`: a faint seam. `bad`: a visible seam. `not_applicable`: the repeat type does not fit this size. EdgeReport: type: object required: - edge - verdict - anomaly - broken description: > One edge where copies of the tile meet. Positions along the `vertical` edge are rows of the tile; along the `horizontal` edge, columns. properties: edge: type: string enum: - vertical - horizontal description: >- `vertical`: where the right side meets the left. `horizontal`: where the bottom meets the top. verdict: type: string enum: - ok - minor - bad description: The level of `anomaly`. anomaly: type: number minimum: 0 description: >- How strong the seam is, on one scale for every edge; higher is stronger. broken: type: array description: The stretches of the edge where the seam shows. items: $ref: '#/components/schemas/Range' Range: type: array description: Half-open pixel range `[start, end)` along an edge. items: type: integer minimum: 0 minItems: 2 maxItems: 2 headers: Location: description: Path of the job, `/v1/jobs/{job_id}`. schema: type: string RetryAfter: description: Seconds to wait before polling again. schema: type: integer minimum: 1 RetryAfterLimit: description: Seconds to wait before trying again. schema: type: integer minimum: 1 responses: AuthRequired: description: | No API key, or one that is revoked or unknown (`auth_required`). content: application/json: schema: $ref: '#/components/schemas/Error' PayloadTooLarge: description: > The image file is larger than 40 MB (`payload_too_large`); refused before it is read in full. content: application/json: schema: $ref: '#/components/schemas/Error' InvalidInput: description: > The request or the image cannot be used. Codes: `validation_error`, `unsupported_format`, `decode_failed`, `too_small`, `too_large`, `odd_dimension` (fix only), `transparent_seam_band` (fix only). content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- An API key of your account, created on makeseamless.com and sent in the `x-api-key` header. Keys start with `smls_`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.