Introduction

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.

Quickstart

Make your first authenticated API call in under 2 minutes.

Authentication

Understand the three caller types and how tokens work.

Watermark Remover

Remove watermarks from images with a single API call.

API Reference

Full reference for every endpoint, with a live Try-It console.

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

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

Error

{
  "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

Get Started

Core Concepts

Guides

Overview

Quickstart

Authentication

Watermark Remover

API Reference

Base URL

What you can do

Response format

SDKs and clients

​Overview

Quickstart

Authentication

Watermark Remover

API Reference

​Base URL

​What you can do

​Response format

​SDKs and clients

Overview

Base URL

What you can do

Response format

SDKs and clients