# GoStudio API

> REST API documentation for the GoStudio Watermark Remover — remove watermarks from images with a single authenticated call.

- [Introduction](https://docs.gostudio.ai/docs/introduction.md): The GoStudio Watermark Remover API removes watermarks from images with a single authenticated HTTP call.
- [Quickstart](https://docs.gostudio.ai/docs/quickstart.md): Make your first authenticated API call in under 2 minutes.
- [Authentication](https://docs.gostudio.ai/docs/authentication.md): Every request to the GoStudio API must include a Bearer token. This page explains the three caller types and how to obtain each.
- [Response Format](https://docs.gostudio.ai/docs/response-format.md): All GoStudio API responses use a consistent JSON envelope regardless of success or failure.
- [Error Codes](https://docs.gostudio.ai/docs/errors.md): Reference for the error codes you are most likely to encounter, organized by HTTP status. Match on error.code; treat any unlisted code as its error.type implies.
- [Pagination](https://docs.gostudio.ai/docs/pagination.md): List endpoints in the GoStudio v2 API use cursor-based pagination. This page explains how to traverse pages, filter results, and sort responses.
- [Watermark Remover](https://docs.gostudio.ai/docs/guides/watermark-remover.md): A complete walkthrough of the Watermark Remover API from model selection to error handling.
- [Remove a watermark](https://docs.gostudio.ai/api-reference/watermark-remover/remove-a-watermark.md): Submits an image for watermark removal. This is the endpoint most integrations should use — it validates the request, runs the generation, writes a generation log, and deducts credits in one call.
- [Get tool metadata](https://docs.gostudio.ai/api-reference/watermark-remover/get-tool-metadata.md): Returns the available models, their credit cost and tier, the default model, tier aliases, polling timings, and UI hints. Call this instead of hard-coding model IDs — the model list changes over time.
- [Poll job status](https://docs.gostudio.ai/api-reference/watermark-remover/poll-job-status.md): Looks up a watermark removal job by its `job_id`. `output_urls` and `credits_deducted` appear once `status` is `completed`; `error` appears when it is `failed`.
- [Generate only (no logging or billing)](https://docs.gostudio.ai/api-reference/watermark-remover/generate-only-no-logging-or-billing.md): Runs the model and returns the output without writing a generation log or deducting credits. The result never appears in `/api/v2/me/generations`, and it cannot be finalized through `/record` — that endpoint only finalizes a generation log that already exists, and nothing creates one for this call.…
- [Record a generation result](https://docs.gostudio.ai/api-reference/watermark-remover/record-a-generation-result.md): Finalizes an existing generation log — stores the output URLs and marks the job completed, or marks it failed and refunds the credits that were reserved for it at submit time. Credits are deducted when the generation is submitted, not here; `credits_deducted` echoes the amount already charged. A job…
- [Provider callback (internal)](https://docs.gostudio.ai/api-reference/webhooks/provider-callback-internal.md): Receives async completion callbacks from the upstream model providers (Replicate, Astria, Fal). **Not for your application to call** — configure `webhook_url` on a generation request to receive results instead.

## OpenAPI Specs

- [openapi](/openapi.yaml)