GhostGPT API

С чего начать

Getting started

Три шага, каждый занимает минуту.

Three steps, a minute each.

1. Зарегистрируйтесь на ghostgpt.io: почта и пароль, Google или Telegram. Телефон не нужен.
2. На странице API-ключа выберите API-тариф — API Start или API Pro — и оплатите криптовалютой, зарубежной картой (Visa / Mastercard) или через СБП по QR (для России). Платёж разовый, без автосписаний. С оплаченной подпиской на чат API можно сначала попробовать на небольшом пробном лимите.
3. Там же нажмите «Получить API-ключ». Ключ показывается ровно один раз.

1. Sign up at ghostgpt.io: email and password, Google or Telegram. No phone number.
2. On the API key page choose an API plan — API Start or API Pro — and pay with crypto, a Visa / Mastercard card, or SBP QR (Russia). One-off payment, no recurring charges. With a paid chat subscription you can first try the API on a small trial allowance.
3. Press “Get an API key” on the same page. The key is shown exactly once.

Дальше — настройки клиента:

Then configure your client:

Проверка одной командой — она не тратит квоту:

One-command check — it does not consume quota:

curl https://api.ghostgpt.io/v1/models \
  -H "Authorization: Bearer SK-YOUR-KEY"

Машиночитаемый манифест: /api.json

Machine-readable manifest: /api.json

Важно: https://api.ghostgpt.io/v1 — это Base URL для клиента, а не страница в браузере. Документация живёт на /, проверка ключа — на /v1/models.

Note: https://api.ghostgpt.io/v1 is a client Base URL, not a browsable page. Docs live at /; check the key at /v1/models.

Тарифы API

API plans

Документация открыта всем. Сам API оплачивается отдельно от чата: подписка на чат его не включает (кроме небольшого пробного лимита), а API-тариф ничего не добавляет в чат. Счётчики у них тоже раздельные — запросы по ключу не тратят сообщения чата.

The documentation is public. The API itself is paid separately from the chat: a chat subscription does not include it (apart from a small trial allowance), and an API plan adds nothing to the chat. Their counters are separate too — requests by key never spend chat messages.

Главная мера — токены ответа. Ответ на 4 096 токенов занимает видеокарту столько же, сколько сорок коротких, поэтому суточный лимит считается в выданных моделью токенах (usage.completion_tokens), а число запросов — лишь защита от шквала мелких. Токены вашего вопроса в лимит не входят.

Output tokens are the main measure. A 4,096-token answer takes the GPU as long as forty short ones, so the daily limit counts the tokens the model produced (usage.completion_tokens); the request count only guards against a flood of tiny calls. Your prompt tokens do not count.

Мест на API Pro немного. Сервис работает на одной видеокарте вместе с чатом, поэтому одновременно действующих тарифов Pro — несколько. Когда места заняты, страница оплаты говорит об этом до платежа; продлить свой Pro можно всегда, пока он действует и ещё 72 часа после его конца.

API Pro has a few seats. The service runs on one GPU together with the chat, so only a few Pro plans can be active at once. When all seats are taken the payment page says so before you pay; renewing your own Pro is always possible while it runs and for 72 hours after it ends.

72 часа после конца тарифа — не подарок, а защита от простоя: тариф может кончиться в три часа ночи, и ваш продакшен обязан дожить до утра. В эти часы каждый ответ несёт заголовок Warning: 199 ghostgpt "…"; до конца суток, в которые тариф кончился, действуют его лимиты (расход этих суток уже на счётчиках), со следующих — пробный. Тот же заголовок приходит и за трое суток до конца.

The 72-hour window is not a gift but downtime protection: a plan can end at 3 a.m., and your production must survive until morning. During that window every response carries Warning: 199 ghostgpt "…"; for the rest of the UTC day the plan ended its limits still apply (that day’s use is already on the counters), from the next day the trial allowance does. The same header also arrives during the three days before the end.

Продление и смена тарифа. Покупка того же тарифа добавляет 30 дней к остатку. Покупка другого не сжигает оплаченное: оставшиеся дни пересчитываются по ценам тарифов, так что ни в одну сторону это не выгоднее и не дороже прямой покупки (с Start на Pro — ×0,38, с Pro на Start — ×2,6), и к ним добавляются 30 дней нового тарифа. Ключ после оплаты оживает сам — перевыпускать его не нужно.

Renewing and switching. Buying the same plan adds 30 days to what is left. Buying the other one does not burn what you paid: the remaining days are converted at the plans’ prices, so neither direction is worth more or less than buying outright (Start to Pro ×0.38, Pro to Start ×2.6), and the new plan’s 30 days are added on top. After payment the key comes back by itself — no re-issue needed.

Ключи, выданные до 12.10.2026, когда API входил в подписку на чат, сохраняют прежние лимиты (250 запросов и 150 000 токенов в сутки) до конца уже оплаченного срока подписки. Дальше — API-тариф.

Keys issued before 12.10.2026, when the API came with the chat subscription, keep the previous limits (250 requests and 150,000 tokens a day) until the end of the subscription already paid for. After that, an API plan.

Действующие цены — на странице API-ключа, они главнее этой таблицы. API-тарифы продаются на сайте — криптовалютой, зарубежной картой или через СБП; оплата разовая: автосписаний нет, карта не привязывается. Для всех стран цена одна.

Current prices are on the API key page and take precedence over this table. API plans are sold on the site, with crypto, a card or SBP; payments are one-off: no recurring charges, no stored cards. The price is the same for every country.

Ключ

API key

Authorization: Bearer SK-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

• Ключ принадлежит вашему аккаунту на сайте — тому же, в который вы входите почтой, через Google или Telegram. Что ключу доступно, решает API-тариф этого аккаунта, а не подписка на чат.
• Один живой ключ на аккаунт. Повторная выдача перевыпускает: старый умирает в тот же миг, когда рождается новый.
• На сервере хранится только HMAC ключа. Восстановить его нельзя ни нам, ни вам — потеряли, значит перевыпускайте.
• Рядом с ключом выдаётся публичный key_id вида K7ZQ3M2X1. Он не секретен: по нему поддержка находит вашу запись, не спрашивая сам ключ. Тот же key_id возвращается заголовком X-GhostGPT-Key-Id.
• Блокировка аккаунта, отзыв ключа и стирание данных закрывают доступ немедленно, а не к следующим суткам.
• Ключ — серверный секрет. Не кладите его в браузерный код, мобильное приложение или публичный репозиторий: любой, кто его прочитает, тратит вашу квоту.

• The key belongs to your account on the site — the one you sign in to by email, Google or Telegram. What the key may do is set by that account’s API plan, not by the chat subscription.
• One live key per account. Issuing again rotates it: the old one dies the moment the new one is born.
• Only an HMAC of the key is stored. Neither we nor you can recover it — if it is lost, issue a new one.
• Along with the key you get a public key_id such as K7ZQ3M2X1. It is not secret: support can find your record without ever seeing the key. The same value comes back in the X-GhostGPT-Key-Id header.
• Blocking the account, revoking the key and erasing data all take effect immediately, not at the next daily reset.
• The key is a server-side secret. Do not ship it in browser code, mobile apps or public repos: anyone who reads it spends your quota.

Управление ключом

Managing the key

Через интерфейс — на странице API-ключа: получить, заменить, отключить. Через HTTP — с cookie сессии сайта, то есть после входа почтой, через Google или Telegram. POST принимается только со страниц самого сайта (проверяется заголовок Origin, иначе 403 {"error": "bad_origin"}) — например, из консоли браузера на открытой вкладке ghostgpt.io:

Through the UI — on the API key page: get, replace, turn off. Over HTTP — with the site's session cookie, that is after signing in by email, Google or Telegram. A POST is accepted only from the site’s own pages (the Origin header is checked, otherwise 403 {"error": "bad_origin"}) — for example, from the browser console on an open ghostgpt.io tab:

{
  "key": {"key_id": "K7ZQ3M2X1", "created_at": 1787930020, "last_used_at": null},
  "api": {
    "plan": "start",
    "until": 1790522020,
    "grace": false,
    "daily_requests": 1500,
    "daily_out_tokens": 300000,
    "concurrency": 1,
    "used_requests": 12,
    "used_out_tokens": 8400,
    "reset_at": 1787961600
  },
  "secret": "SK-…"
}

api.plan — start, pro, legacy (ключи до 12.10.2026), trial (пробный лимит подписки на чат) или null, если API недоступен. grace: true — тариф кончился и идут 72 часа льготы: до конца тех суток (UTC), в которые он кончился, — его лимиты, дальше пробный; plan всё это время называет кончившийся тариф.

api.plan is start, pro, legacy (keys from before 12.10.2026), trial (the trial allowance of a chat subscription) or null when the API is not available. grace: true means the plan has ended and its 72-hour grace is running: the plan’s limits until the end of the UTC day it ended, then the trial allowance; all the while plan names the plan that ended.

Поле secret приходит только в ответе на выдачу — больше нигде и никогда.

The secret field appears only in the issue response — nowhere else, ever.

Где принимается ключ

Where the key is accepted

На api.ghostgpt.io (основной адрес), на ghostgpt.io — второй оставлен для клиентов, заведённых до появления отдельного домена, — и на onion-зеркале (см. ниже). Cookie веб-чата работает на ghostgpt.io, app.ghostgpt.io и на зеркале, но не на api.ghostgpt.io.

On api.ghostgpt.io (the main address), on ghostgpt.io — the latter is kept for clients set up before the separate domain existed — and on the onion mirror (see below). The web-chat cookie works on ghostgpt.io, app.ghostgpt.io and on the mirror, but not on api.ghostgpt.io.

Если в Authorization положить старый токен входа (GG-…, их выдавали до 11.10.2026) вместо ключа, ответ будет 401 use_api_key: токен открывает сайт, а программам нужен ключ SK-…. Код назван отдельно, чтобы вы не искали опечатку.

Putting an old sign-in token (GG-…, issued until 11.10.2026) into Authorization instead of a key returns 401 use_api_key: the token opens the site, programs need an SK-… key. The code is separate so you do not go hunting for a typo.

Ключи из старого общего списка, выданные до ключей аккаунтов, принимаются до 31.12.2026. Ответы на них несут заголовки Deprecation: true, Sunset: Wed, 31 Dec 2026 23:59:59 GMT и Link на этот раздел; после этой даты такой ключ получает 401 invalid_api_key. Замените его своим ключом SK-… со страницы ключа.

Keys from the old shared list, issued before account keys, are accepted until 31.12.2026. Responses to them carry Deprecation: true, Sunset: Wed, 31 Dec 2026 23:59:59 GMT and a Link to this section; after that date such a key gets 401 invalid_api_key. Replace it with your own SK-… key from the key page.

Доступ через Tor

Access over Tor

Тот же API отвечает на onion-зеркале — без выхода в обычный интернет и без DNS:

The same API answers on the onion mirror — with no exit to the ordinary internet and no DNS:

http://ghostgptdcxf76dzznn6wv4gzruvfs4h4bx7rootrwluxxvbtujiueqd.onion/v1

Ключ предъявляется так же, тем же заголовком Authorization; отдельного адреса вида api.…onion нет и не нужно. Схема только http: сертификата для .onion не существует, шифрование и подлинность адреса обеспечивает сама сеть Tor.

The key is presented the same way, in the same Authorization header; there is no separate api.…onion address and none is needed. The scheme is http only: no certificate exists for .onion, and encryption plus address authenticity come from the Tor network itself.

curl --socks5-hostname 127.0.0.1:9050 \
  http://ghostgptdcxf76dzznn6wv4gzruvfs4h4bx7rootrwluxxvbtujiueqd.onion/v1/chat/completions \
  -H "Authorization: Bearer SK-…" \
  -H "Content-Type: application/json" \
  -d '{"model":"ghostgpt","messages":[{"role":"user","content":"ping"}]}'

В библиотеке OpenAI достаточно подменить base_url и направить транспорт в SOCKS5-порт Tor (обычно 9050; в Tor Browser — 9150).

With the OpenAI library it is enough to swap base_url and point the transport at Tor's SOCKS5 port (usually 9050; 9150 in Tor Browser).

Предел «запросов в минуту с адреса» на зеркале считается по ключу. Адреса клиента там не существует: соединение приходит от локального демона Tor, и по адресу все гости зеркала неотличимы. Поэтому запрос с ключом считается по самому ключу: у каждого ключа своё ведро с той же ставкой в минуту, что у адреса на api.ghostgpt.io. Предел одновременных запросов вашего тарифа действует одинаково везде.

On the mirror the per-IP rate limit counts per key. There is no client address there: the connection arrives from the local Tor daemon, so by address all mirror visitors are indistinguishable. A request with a key is therefore counted by the key itself: each key gets its own bucket at the same per-minute rate an address gets on api.ghostgpt.io. Your plan’s limit on concurrent requests applies everywhere alike.

Модель

Model

Любое значение поля model переписывается на текущую модель. Прислали gpt-4o — получите тот же ghostgpt, ошибки не будет. В ответе всегда стоит "model": "ghostgpt".

Whatever you put in model is rewritten to the current model. Send gpt-4o and you still get ghostgpt, without an error. Responses always carry "model": "ghostgpt".

Модель обслуживает два запроса одновременно на весь сервис. Запросам по ключам — всем аккаунтам вместе — отдан один из двух, второй всегда остаётся веб-чату, поэтому ключам модель отвечает по одному. Предел на аккаунт — сколько запросов может быть открыто сразу: Start — 1, Pro — 2, пробный — 1. Пока место ключей занято другим ответом, запрос ждёт своей очереди: у Pro второй запрос встанет в очередь, а не получит 429. См. Лимиты.

The model serves two requests at a time for the whole service. Requests by key, all accounts together, get one of the two; the other always stays with the web chat, so the model answers keys one at a time. The per-account limit is how many requests may be open at once: Start 1, Pro 2, trial 1. While the keys' slot is busy with another answer, a request waits its turn: on Pro a second request joins the line instead of getting a 429. See Limits.

Эндпоинты

Endpoints

Любой другой путь под /v1/ отвечает 404 unknown_endpoint в формате ошибки OpenAI — в том числе /v1/completions, /v1/embeddings, /v1/responses, /v1/messages.

Any other path under /v1/ returns 404 unknown_endpoint in the OpenAI error format — including /v1/completions, /v1/embeddings, /v1/responses, /v1/messages.

/v1/models никогда не отвечает 402. Это ручка, которой библиотеки проверяют связь при старте: отказ по выбранной квоте означал бы, что приложение не может подняться до полуночи UTC, не потратив ни одного токена.

/v1/models never returns 402. Client libraries call it at startup: refusing on an exhausted quota would mean the app cannot even boot until midnight UTC without spending a single token.

Chat Completions

Формат — как у OpenAI Chat API. Совместимость проверена на официальном SDK openai для Python и Node без единой правки.

Same shape as the OpenAI Chat API. Verified against the official openai SDK for Python and Node with no changes.

curl

curl https://api.ghostgpt.io/v1/chat/completions \
  -H "Authorization: Bearer SK-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ghostgpt",
    "messages": [
      {"role": "user", "content": "Hello! What is GhostGPT API?"}
    ],
    "max_tokens": 512
  }'

Python (openai)

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.ghostgpt.io/v1",
    api_key=os.environ["GHOSTGPT_API_KEY"],   # the key lives in the environment, not in the code
)

resp = client.chat.completions.create(
    model="ghostgpt",
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=512,
)
print(resp.choices[0].message.content)
print(resp.usage.completion_tokens)          # output tokens are always counted

Node (openai)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ghostgpt.io/v1",
  apiKey: process.env.GHOSTGPT_API_KEY,
});

const r = await client.chat.completions.create({
  model: "ghostgpt",
  messages: [{ role: "user", content: "Hello" }],
  max_tokens: 512,
});
console.log(r.choices[0].message.content);

Обработка отказов

Handling refusals

import os, time
import openai

client = openai.OpenAI(
    base_url="https://api.ghostgpt.io/v1",
    api_key=os.environ["GHOSTGPT_API_KEY"],
    max_retries=0,                             # retries are decided below
)

def ask(messages, tries=3):
    for _ in range(tries):
        try:
            return client.chat.completions.create(model="ghostgpt", messages=messages)
        except openai.APIStatusError as e:
            if e.code == "capacity_exhausted":     # service-wide ceiling: back after 00:00 UTC
                raise
            if e.status_code in (429, 503):        # your own parallel request, or a busy model
                time.sleep(int(e.response.headers.get("Retry-After", 5)))
                continue
            raise                                  # 401 and 402 do not pass on retry
    raise RuntimeError("giving up")

Повторять стоит только 429 и 503 — кроме 503 capacity_exhausted: общий суточный потолок сервиса освободится только в 00:00 UTC, и повтор по его Retry-After: 300 лишь потратит ваши попытки. 401 означает неверный ключ, 402 — нет тарифа или кончились его лимиты на сегодня: ни то ни другое от повтора не исправится. Встроенные повторы SDK выключены (max_retries=0), чтобы решал ваш код, а не библиотека: сама она повторила бы и capacity_exhausted.

Only 429 and 503 are worth retrying — except 503 capacity_exhausted: the service-wide daily ceiling frees up only at 00:00 UTC, and retrying on its Retry-After: 300 just burns your attempts. 401 means a bad key, 402 means there is no plan or its limits for today are spent: neither is fixed by retrying. The SDK’s own retries are off (max_retries=0) so that your code decides, not the library: left on, it would retry capacity_exhausted too.

Стриминг

Streaming

Добавьте "stream": true — ответ пойдёт чанками SSE, как в OpenAI.

Add "stream": true and the answer arrives as SSE chunks, OpenAI-style.

curl -N https://api.ghostgpt.io/v1/chat/completions \
  -H "Authorization: Bearer SK-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ghostgpt",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a short poem"}]
  }'

• Последним перед data: [DONE] приходит чанк с блоком usage. Он присылается всегда, если поток не оборвал сам сервер (сторожем или из-за сбоя, см. ниже): сервер сам ставит stream_options.include_usage, потому что по этому числу считается суточный потолок токенов. Если ваш клиент его не ждёт — просто игнорируйте.
• Обрыв соединения с вашей стороны квоту не возвращает: токены уже сгенерированы.
• Если модель ушла в вырожденный повтор, поток обрывается чанком с finish_reason: "length".
• Если ответ попытался раскрыть внутренние инструкции или назвать курс валюты без данных, приходит короткий отказ с finish_reason: "stop". Так же кончается поток, сорвавшийся на нашей стороне, — текстом «The service is temporarily unavailable…», а если Accept-Language клиента ставит русский первым, то «Сервис временно недоступен…». Язык отказов сторожей и internal_error выбирается так же.
• Прокси не режет поток по таймауту чтения: поток идёт, пока модель пишет ответ, а длину ответа ограничивает max_tokens. Предел в 600 секунд — только у ответа без потока.

• The chunk right before data: [DONE] carries a usage block. It is sent always, unless the server itself cut the stream short (a guard or a failure, see below): the server sets stream_options.include_usage itself, because the daily token ceiling is counted from it. If your client does not expect it, just ignore it.
• Disconnecting on your side does not refund quota: the tokens were already generated.
• If the model falls into degenerate repetition, the stream is cut with finish_reason: "length".
• If a response tried to leak internal instructions or quote an FX rate without data, you get a short refusal with finish_reason: "stop". A stream that breaks on our side ends the same way, with the short text “The service is temporarily unavailable…”, in Russian when your client’s Accept-Language puts Russian first. The guards’ refusals and internal_error pick their language the same way.
• The proxy does not cut streams on read timeout: a stream runs while the model writes, and max_tokens bounds the length of the answer. The 600-second limit applies only to an answer without a stream.

Изображения

Images

Формат OpenAI: base64 data-URI или ссылка.

OpenAI format: base64 data-URI or a URL.

{
  "model": "ghostgpt",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "What is in this image?"},
      {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,..."}}
    ]
  }]
}

• Одна картинка стоит до 768 токенов контекста.
• Максимальный размер тела запроса — 32 МБ (иначе 413 payload_too_large, а на ghostgpt.io/v1 и onion-зеркале — 413 request_too_large); base64 раздувает файл примерно на треть.
• Генерации изображений нет — только чтение.

• One image costs up to 768 context tokens.
• Max request body is 32 MB (otherwise 413 payload_too_large, or 413 request_too_large on ghostgpt.io/v1 and the onion mirror); base64 inflates a file by roughly a third.
• There is no image generation — reading only.

Что сервер меняет в запросе

What the server rewrites

Шлюз не проксирует тело как есть. Перечислено всё, что он трогает, — остальное уходит в модель нетронутым.

The gateway does not pass the body through untouched. Everything it changes is listed below; the rest goes to the model as is.

На выходе стоят три сторожа: утечка внутреннего промпта, вырожденный повтор и курсы валют, названные без данных с сайта. Утечку и курсы они обрывают и в потоке, и в обычном ответе, вырожденный повтор — только в потоке.

Three output guards are in place: internal-prompt leakage, degenerate repetition, and FX rates quoted without web data. Leakage and FX rates are cut short in streamed and plain answers alike, degenerate repetition in streams only.

Лимиты

Limits

Счётчики обнуляются в 00:00 UTC. Точное время сброса приходит заголовком, гадать не нужно. Лимит токенов проверяется перед запросом: запрос, который его перешагнёт, доработает до конца, отказ получит следующий. Поток, оборванный вашей стороной, тоже учитывается — по тому, сколько текста успело уйти.

Общий потолок защищает веб-чат: он работает на той же видеокарте, а лимиты всех тарифов вместе могут превысить то, что она выдаёт за сутки. Когда потолок выбран, запросы по ключам получают 503 capacity_exhausted до 00:00 UTC, даже если лимит вашего тарифа ещё не выбран. Повторять такой ответ раньше полуночи бессмысленно — см. Обработка отказов.

Counters reset at 00:00 UTC. The exact reset time comes back in a header, no guessing needed. The token limit is checked before a request: the request that crosses it runs to the end, the next one is refused. A stream you close early is counted too — by how much text had already gone out.

The service-wide ceiling protects the web chat: it runs on the same GPU, and the limits of all plans added together can exceed what the card produces in a day. Once the ceiling is reached, key requests get 503 capacity_exhausted until 00:00 UTC, even if your plan’s own limit is not spent. Retrying before midnight is pointless — see Handling refusals.

Заголовки состояния

State headers

Почему одновременных запросов мало. Модель обслуживает два запроса на весь сервис: один — всем ключам вместе, второй — веб-чату. Пул из десяти потоков всё равно получит ответы по одному, а остальные его запросы простоят в очереди. Ограничитель не «сколько в минуту» (это делает отдельный лимит по адресу), а «сколько прямо сейчас»; он один на аккаунт, на все процессы шлюза сразу.

Why so few requests at once. The model serves two requests for the entire service: one for all keys together, the other for the web chat. A ten-thread pool would still get its answers one at a time, with the rest of its requests waiting in line. This limiter is not about “per minute” (that is the separate per-IP limit) but about “right now”; it holds per account, across all gateway processes.

Квота занимается до обращения к модели и возвращается, если модель не ответила или поток лопнул, не отдав ни байта. Обрыв соединения вашей стороной возвратом не считается.

Quota is reserved before the model call and refunded if the model failed or the stream broke without a single byte. Your own disconnect is not a refund case.

Ошибки

Errors

Тело ошибки на /v1/* — JSON в формате OpenAI; на api.ghostgpt.io так отвечает и сам прокси (404, 413, 429, а пока шлюз перезапускается — 502, 503, 504), а на запасном ghostgpt.io/v1 ошибки прокси приходят его HTML-страницей. Вспомогательные ручки ghostgpt.io/api/* на собственные ошибки отвечают плоским {"error": "<code>"} (и на лимит частоты — {"error": "rate_limit"}), а отказ по ключу — 401, 402, 403 — приходит тем же телом в формате OpenAI и с теми же кодами, что на /v1.

Error bodies on /v1/* are JSON in the OpenAI format; on api.ghostgpt.io this includes the proxy’s own responses (404, 413, 429, and 502, 503, 504 while the gateway restarts), while on the legacy ghostgpt.io/v1 proxy errors come as its HTML page. The auxiliary endpoints on ghostgpt.io/api/* reply to their own errors with a flat {"error": "<code>"} (a rate limit included: {"error": "rate_limit"}), while a refusal by key — 401, 402, 403 — comes in the same OpenAI shape and with the same codes as on /v1.

{
  "error": {
    "message": "Human-readable explanation",
    "type": "insufficient_quota",
    "code": "api_plan_required",
    "plans_url": "https://ghostgpt.io/join-en.html?api=1",
    "request_id": "09ba82f5aa9ed61b"
  }
}

Чего API не умеет

What the API does not do

Здесь честнее сказать сразу, чем оставить это на первый день интеграции.

Better said upfront than discovered on day one of your integration.

• Вызова функций (tools/function calling) нет. Поля tools, tool_choice и родственные ошибки не вызывают: сервер удаляет их из запроса, и ответ приходит обычным текстом, без tool_calls.
• Строгого JSON нет. response_format и json_schema удаляются, ответ приходит текстом. Просите JSON словами и разбирайте с проверкой.
• Своего системного промпта нет. Роли system и developer отбрасываются; поведение задавайте первым сообщением от user.
• Эмбеддингов, аудио, генерации картинок нет — /v1/embeddings, /v1/audio/*, /v1/images/* отвечают 404.
• Responses API и Assistants API нет — только Chat Completions.
• Нескольких ключей на аккаунт нет. Один живой ключ; для второго окружения заводите второй аккаунт.
• Из браузера напрямую ходить нельзя. Ключ серверный: сторонние источники в CORS не разрешены, и класть ключ во фронтенд всё равно означает отдать его первому желающему.
• Тонкой настройки семплинга нет — часть параметров зажата снизу, см. «Что сервер меняет».

• No function calling. tools, tool_choice and related fields do not raise errors: the server removes them from the request, and the answer comes as plain text, without tool_calls.
• No strict JSON. response_format and json_schema are stripped, answers come as text. Ask for JSON in words and parse defensively.
• No custom system prompt. The system and developer roles are dropped; steer behaviour with the first user message.
• No embeddings, audio or image generation — /v1/embeddings, /v1/audio/*, /v1/images/* return 404.
• No Responses API and no Assistants API — Chat Completions only.
• No multiple keys per account. One live key; for a second environment, create a second account.
• No direct browser calls. The key is server-side: no third-party origins are allowed in CORS, and shipping a key to the frontend hands it to anyone who looks.
• No fine sampling control — some parameters are clamped from below, see “What the server rewrites”.

Вспомогательные ручки (ghostgpt.io)

Auxiliary endpoints (ghostgpt.io)

Это не часть OpenAI-совместимого /v1. Они живут на основном домене, принимают тот же ключ и требуют API-тарифа (или оплаченной подписки на чат с пробным лимитом). Лимиты тарифа не тратят, но у каждой свой предел частоты.

These are not part of the OpenAI-compatible /v1. They live on the main domain, accept the same key and require an API plan (or a paid chat subscription with the trial allowance). They do not spend the plan’s limits, but each has its own rate limit.

Отказ по ключу здесь тот же, что на /v1: 401 invalid_api_key, revoked_api_key или use_api_key, 402 api_plan_required, 403 account_blocked — в формате OpenAI. Остальные ошибки — плоский {"error": "<code>"}; превышение частоты — 429 {"error": "rate_limit"} с Retry-After. Разбор PDF идёт в несколько мест на весь сервис: если все заняты дольше 20 секунд, /api/pdf/extract отвечает 429 {"error": "busy"} с Retry-After; так же отвечает /api/transcribe, пока занято распознавание.

A refusal by key is the same as on /v1: 401 invalid_api_key, revoked_api_key or use_api_key, 402 api_plan_required, 403 account_blocked, in the OpenAI shape. Other errors are a flat {"error": "<code>"}; a rate limit is 429 {"error": "rate_limit"} with Retry-After. PDF extraction runs in a few slots for the whole service: when all of them stay taken for more than 20 seconds, /api/pdf/extract answers 429 {"error": "busy"} with Retry-After; /api/transcribe answers the same way while speech recognition is taken.

curl -X POST https://ghostgpt.io/api/fetch-url \
  -H "Authorization: Bearer SK-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Модель сама курсы валют не называет: и она, и сторож на выходе принимают курс только из блока «Данные с сайта» в сообщениях. Если вам нужны курсы, вызовите /api/web-research и допишите поле context из ответа в конец сообщения пользователя как есть — это тот же блок, что подставляет чат. Пустой context значит, что ни один источник не ответил. Свои данные передавайте так же — блоком между такими строками:

The model will not quote FX rates by itself: both the model and an output guard take a rate only from a «Данные с сайта» (site data) block in the messages. If you need rates, call /api/web-research and append the context field of its answer to the end of the user message as is — it is the same block the web chat adds. An empty context means no source answered. Pass your own data the same way, in a block between these lines:

--- Данные с сайта ---
USD: 81.5 RUB за 1 USD
--- конец ---

Приватность

Privacy

• Тексты запросов и ответов не сохраняются. Модель работает на нашем железе и наружу не ходит.
• В журнале веб-сервера нет ни адреса, ни User-Agent, ни Referer — только время, идентификатор запроса, метод, путь, код, объём и длительность.
• Шлюз пишет одну строку на запрос: метод, путь, код, длительность, тип авторизации и идентификатор, а у /v1/chat/completions — ещё размер тела в байтах и число сообщений в диалоге: только числа, без текста. Ключ в журнал не попадает никогда.
• В базе хранится: внутренний идентификатор аккаунта; IP-адрес подключения при регистрации и последний, страна по нему, вид и название сети, огрублённое описание клиента (ОС · браузер · язык) и время последней активности; отпечатки (HMAC) ключа API, способов входа и связки «клиент + подсеть»; хэш пароля (PBKDF2), если вход по почте; адрес почты — зашифрованным (AES-256-GCM), чтобы владелец сервиса видел его в своей панели; у входящих через Telegram — идентификатор и ник в Telegram (ник зашифрован) и язык для уведомлений об оплате; отметка об отписке от писем о сервисе, если вы отписались; даты подписки, суточные счётчики и платежи (180 дней). У аккаунтов, заведённых до 11.10.2026 по токену, — ещё HMAC токена и кода отзыва. Если вы пришли по рекламной ссылке — метка кампании (первое касание) и записи переходов. Подробно — в политике приватности.
• Стирание аккаунта — POST ghostgpt.io/api/access/erase из вашей сессии (cookie входа; запрос принимается только со страниц самого сайта — например, из консоли браузера на открытой вкладке ghostgpt.io; кнопки в интерфейсе пока нет). Удаляет счётчики, ключи, пароль, адрес почты, способы входа, метку кампании, данные Telegram, отметку об отписке, IP-адрес, страну, сведения о сети и клиенте, время последней активности и связь с платежами; войти в этот аккаунт после этого нельзя. Сама строка платежа остаётся обезличенной — это бухгалтерия.
• CDN перед сервисом нет: запросы приходят прямо к нам.
• Публичная ссылка на диалог — действительно публичная. Идентификатор случайный (72 бита), но кто знает ссылку, тот видит содержимое.

• Prompt and response texts are not stored. The model runs on our own hardware and never calls out.
• The web-server log has no IP, no User-Agent, no Referer — only time, request id, method, path, status, size and duration.
• The gateway writes one line per request: method, path, status, duration, auth type and id; for /v1/chat/completions also the body size in bytes and the number of messages in the conversation — numbers only, no text. The key never reaches the log.
• The database stores: an internal account id; the connection IP address at sign-up and the latest one, the country derived from it, the network type and name, a coarse client description (OS · browser · language) and the last-activity time; fingerprints (HMAC) of the API key, of the ways in and of the client + subnet pair; a password hash (PBKDF2) if you sign in by email; the email address, encrypted (AES-256-GCM), so that the service owner can see it in the admin panel; for people who sign in through Telegram, the Telegram id and handle (the handle encrypted) and the language for payment notices; the unsubscribe mark, if you opted out of letters about the service; subscription dates, daily counters and payments (180 days). Accounts opened with a token before 11.10.2026 also keep HMACs of the token and revoke code. If you arrived through an ad link — the campaign label (first touch) and visit records. The details are in the privacy policy.
• Erasing the account — POST ghostgpt.io/api/access/erase from your session (sign-in cookie; the request is accepted only from the site’s own pages — for example, from the browser console on an open ghostgpt.io tab; there is no UI button yet). It removes counters, keys, the password, the email address, the ways in, the campaign label, Telegram data, the unsubscribe mark, the IP address, country, network and client details, the last-activity time and the link to payments; nobody can sign in to that account afterwards. The payment row itself stays, anonymised — that is accounting.
• There is no CDN in front of the service: requests come straight to us.
• A public conversation link is genuinely public. The id is random (72 bits), but whoever has the link sees the content.

Вопросы

FAQ

Ключ перестал работать посреди дня — почему?

The key stopped working mid-day — why?

Посмотрите code в теле ответа. token_quota_exceeded или api_quota_exceeded — выбраны лимиты тарифа на сегодня, сбросятся в 00:00 UTC (остаток видно заранее в X-GhostGPT-Token-Remaining и X-GhostGPT-Quota-Remaining). api_plan_required — кончился тариф. revoked_api_key — ключ перевыпущен, и где-то работает старая копия.

Check code in the response body. token_quota_exceeded or api_quota_exceeded — the plan’s limits for today are spent and reset at 00:00 UTC (the remainder is visible in advance in X-GhostGPT-Token-Remaining and X-GhostGPT-Quota-Remaining). api_plan_required — the plan ended. revoked_api_key — the key was rotated and an old copy is still deployed somewhere.

Можно один ключ на команду?

Can a team share one key?

Технически да, но лимиты одни на аккаунт, а открытых запросов сразу — столько, сколько даёт тариф (Start — 1, Pro — 2); отвечает модель всем ключам по одному. Для независимых нагрузок дешевле Pro или два аккаунта, чем очередь из 429.

Technically yes, but the limits are per account, and an account may have as many requests open at once as its plan gives (Start 1, Pro 2); the model answers all keys one at a time. For independent workloads, Pro or two accounts are cheaper than a queue of 429s.

Как проверить ключ, не тратя квоту?

How do I verify a key without spending quota?

GET /v1/models. Она не тратит ничего и никогда не отвечает 402; заодно вернёт заголовки с тарифом, остатком лимитов и сроком тарифа.

GET /v1/models. It costs nothing and never returns 402; it also brings back headers with the plan, the remaining limits and the plan’s end.

Ответы иногда обрываются на середине

Answers sometimes cut off mid-sentence

Если finish_reason: "length" — упёрлись в max_tokens или сработал сторож повторов. Если "stop" и текст короткий — сработал сторож на утечку промпта или на курсы валют без данных.

With finish_reason: "length" you hit max_tokens or the repetition guard. With "stop" and a short text, the prompt-leak or FX guard fired.

Работает ли OpenAI SDK без правок?

Does the OpenAI SDK work unchanged?

Да. Достаточно подменить base_url и api_key. Модель называйте ghostgpt — впрочем, любое имя всё равно будет переписано.

Yes. Just swap base_url and api_key. Use ghostgpt as the model name — although any name gets rewritten anyway.

Что будет с интеграцией, если я забуду продлить?

What happens to my integration if I forget to renew?

72 часа она проживёт с заголовком Warning: до конца суток (UTC), в которые кончился тариф, — на его лимитах, дальше на пробном. За трое суток до конца тарифа тот же заголовок приходит заранее — повесьте на него алерт, и сюрприза не будет.

It survives 72 hours with a Warning header: on the plan’s limits until the end of the UTC day it ended, then on the trial allowance. The same header appears three days before the plan ends — hook an alert to it and there will be no surprise.

Куда писать, если что-то сломалось?

Where do I report a problem?

Через ghostgpt.io. Приложите X-Request-ID и key_id — этого хватит, чтобы найти вашу строку. Сам ключ присылать не нужно и не следует.

Via ghostgpt.io. Include X-Request-ID and key_id — that is enough to find your log line. Do not send the key itself.