> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gostudio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The GoStudio Watermark Remover API removes watermarks from images with a single authenticated HTTP call.

<img src="https://www.gostudio.ai/og.webp" alt="GoStudio API" style={{ borderRadius: "0.5rem" }} />

## Overview

The **GoStudio v2 REST API** is a JSON-over-HTTPS API built for developers who want to integrate AI image processing into their products. Every request is authenticated, every response follows a consistent envelope, and every error carries a machine-readable code.

This documentation covers the **Watermark Remover** tool: submitting an image, choosing a model tier, reading the result, and handling failures. The wider v2 API has further endpoints for account and media management; they are not documented here.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/docs/quickstart">
    Make your first authenticated API call in under 2 minutes.
  </Card>

  <Card title="Authentication" icon="lock" href="/docs/authentication">
    Understand the three caller types and how tokens work.
  </Card>

  <Card title="Watermark Remover" icon="wand-magic-sparkles" href="/docs/guides/watermark-remover">
    Remove watermarks from images with a single API call.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Full reference for every endpoint, with a live Try-It console.
  </Card>
</CardGroup>

## Base URL

All API requests go to the following base URL:

```
https://www.gostudio.ai
```

All endpoints are prefixed with `/api/v2/`.

## What you can do

| Endpoint                                | Purpose                                                                                                           |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `POST /apps/watermark-remover`          | Remove a watermark from an image using the `lite`, `pro`, or `advance` model tier. One call, one finished result. |
| `GET /apps/watermark-remover/info`      | List the available models with their tier, price in credits, and whether they take a prompt.                      |
| `GET /apps/watermark-remover/{jobId}`   | Re-fetch the result of an earlier job.                                                                            |
| `POST /apps/watermark-remover/generate` | Start a generation directly, without the orchestration the main endpoint performs.                                |
| `POST /apps/watermark-remover/record`   | Finalize a job started with `/generate` and record its outcome.                                                   |
| `POST /apps/watermark-remover/webhook`  | Callback used by the AI provider. Not called by your application.                                                 |

## Response format

Every response — success or error — uses a consistent envelope.

**Success**

```json theme={null}
{
  "status": 200,
  "data": {
    "user_id": "049cae5c-e6ef-48ae-b8d8-69d9b44923e3",
    "credits": 42,
    "expires_at": "2026-01-31T00:00:00+00:00"
  }
}
```

**Error**

```json theme={null}
{
  "status": 401,
  "error": {
    "type": "authentication_error",
    "code": "unauthorized",
    "dev": 40100,
    "message": "Missing or invalid Authorization Bearer token."
  }
}
```

## SDKs and clients

The API is plain HTTPS + JSON, so it works with any HTTP client:

* **curl** (all examples in this documentation)
* **Node.js** — `fetch`, `axios`
* **Python** — `httpx`, `requests`
* **Postman, Insomnia, Bruno** — the API Reference is generated from an OpenAPI 3.0 spec, so it imports into any OpenAPI-compatible client