Quickstart

This guide walks you from zero to a working watermark removal request. You need a GoStudio account and a Bearer token — there are no API keys to generate and no GoStudio SDK to install.

Step 1 — Get your Bearer token

The GoStudio API authenticates via a Supabase JWT issued when you log in. Read it from your Supabase Auth client, which holds the session for the signed-in user:

const { data: { session } } = await supabase.auth.getSession();
const token = session.access_token;

Tokens are Supabase JWTs that expire after approximately 1 hour, and the auth client refreshes them for you. Read the token from the client on each request rather than hardcoding it.

Always handle 401 unauthorized responses. Refresh the token through your auth client and retry the request.

Grabbing a token by hand for a one-off test

For manual exploration only — never ship this, and never paste a token into a shared document or issue tracker.

Open gostudio.ai and log in to your account.
Press F12 to open DevTools → go to the Application tab.
Expand Cookies → click https://www.gostudio.ai.
Find the cookie named sb-<project-ref>-auth-token. Large sessions are split into numbered chunks (sb-<project-ref>-auth-token.0, sb-<project-ref>-auth-token.1, …) — concatenate their values in order.
URL-decode the concatenated value to get the session JSON, then copy the access_token string. It starts with eyJ....

If the cookie format does not match what you see, get the token from your auth client instead — that is the supported path.

Step 2 — Verify your token and check model pricing

Before running any generation, confirm your token works and see which models you can use. GET /apps/watermark-remover/info does both — it is the cheapest call to prove your credentials, and it returns the current model IDs and their prices:

curl https://www.gostudio.ai/api/v2/apps/watermark-remover/info \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://www.gostudio.ai/api/v2/apps/watermark-remover/info", {
  headers: { Authorization: "Bearer YOUR_TOKEN" }
});
const data = await res.json();
console.log(data);

import httpx
r = httpx.get(
    "https://www.gostudio.ai/api/v2/apps/watermark-remover/info",
    headers={"Authorization": "Bearer YOUR_TOKEN"}
)
print(r.json())

Expected response

{
  "status": 200,
  "data": {
    "default_model": "dewatermark/watermark-remover-pro",
    "tiers": {
      "lite": "dewatermark/watermark-remover-pro",
      "pro": "replicate/pruna-image-edit",
      "advance": "astria/seedream-5-pro"
    },
    "models": [
      {
        "id": "dewatermark/watermark-remover-pro",
        "tier": "lite",
        "provider": "dewatermark",
        "requires_prompt": false,
        "pricing": { "type": "flat", "credits": 4 }
      }
    ]
  }
}

Read pricing.credits rather than hard-coding a cost — it is what your account will be charged. If you see a 401, your token is invalid or expired; repeat Step 1.

Step 3 — Remove a watermark

Send a POST to /api/v2/apps/watermark-remover with an image URL and a model tier:

curl -X POST https://www.gostudio.ai/api/v2/apps/watermark-remover \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image-with-watermark.jpg",
    "model_id": "lite"
  }'

const res = await fetch("https://www.gostudio.ai/api/v2/apps/watermark-remover", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    image_url: "https://example.com/image-with-watermark.jpg",
    model_id: "lite"
  })
});
const data = await res.json();
console.log(data.data.output_urls);

import httpx
r = httpx.post(
    "https://www.gostudio.ai/api/v2/apps/watermark-remover",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "image_url": "https://example.com/image-with-watermark.jpg",
        "model_id": "lite"
    }
)
print(r.json()["data"]["output_urls"])

Expected response

{
  "status": 200,
  "data": {
    "job_id": 12345,
    "status": "completed",
    "output_urls": ["https://r2.gostudio.ai/g/k7p2qm9x/i/p4w7t1.jpg"],
    "credits_deducted": 4,
    "credit_balance": 38
  }
}

The output_urls array contains the processed image(s), ready to use immediately. Treat the URLs as opaque — the hostname and path shape are not part of the contract, so do not hardcode or CSP-pin the host.

Get Started

Core Concepts

Guides

Step 1 — Get your Bearer token

Step 2 — Verify your token and check model pricing

Step 3 — Remove a watermark

Next steps

Authentication

Watermark Remover Guide

​Step 1 — Get your Bearer token

​Step 2 — Verify your token and check model pricing

​Step 3 — Remove a watermark

​Next steps

Authentication

Watermark Remover Guide

Step 1 — Get your Bearer token

Step 2 — Verify your token and check model pricing

Step 3 — Remove a watermark

Next steps