GhostGPT API

С чего начать

Getting started

Дайте пользователям одну ссылку — эту страницу:

Share one link with your users — this page:

https://api.ghostgpt.io/

В настройках клиента укажите:

In your client settings use:

JSON-манифест: /api.json

Machine-readable manifest: /api.json

Важно: https://api.ghostgpt.io/v1 — это Base URL для клиентов, не страница в браузере. Откройте / (документация) или проверьте API: /v1/models.

Note: https://api.ghostgpt.io/v1 is the client Base URL, not a browsable page. Use / for docs or try /v1/models.

Авторизация

Authentication

api.ghostgpt.io — обязателен заголовок Authorization: Bearer <api_key>.

api.ghostgpt.io requires Authorization: Bearer <api_key>.

Веб-чат на ghostgpt.io: cookie gg_sess после POST /api/session/bootstrap (или тот же Bearer).

Web chat on ghostgpt.io: gg_sess cookie after POST /api/session/bootstrap, or Bearer key.

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

Политика запросов

Request policy

• system в messages игнорируется — сервер подставляет свой промпт GhostGPT.
• Отклоняются/удаляются: grammar, json_schema, logit_bias (DoS-защита).
• max_tokens: 32–4096; меньше 32 → 4096.
• Курсы валют без данных с сайта — отказ; для API вызывайте POST /api/web-research на ghostgpt.io и добавляйте текст в user-сообщение.
• Ответы с утечкой внутреннего system prompt блокируются (в т.ч. в stream).
• Очередь GPU — один inference одновременно.

• Client system messages are ignored — server injects GhostGPT prompt.
• Stripped: grammar, json_schema, logit_bias (anti-DoS).
• max_tokens: 32–4096; below 32 clamped to 4096.
• FX rates without web data are refused — call POST /api/web-research on ghostgpt.io for API workflows.
• Responses that leak the internal system prompt are blocked (including streaming).
• Single-GPU queue — one inference at a time.

Модели

Models

Список моделей:

List models:

GET https://api.ghostgpt.io/v1/models

Основная модель:

Default model:

ghostgpt

Мультимодальность — текст и изображения в messages.

Multimodal — text and images in messages are supported.

Эндпоинты

Endpoints

Chat Completions

Основной способ — OpenAI Chat API.

Main method — same as OpenAI Chat API.

curl

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

Python (openai)

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ghostgpt.io/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="ghostgpt",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

JavaScript (fetch)

const r = await fetch("https://api.ghostgpt.io/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "ghostgpt",
    messages: [{ role: "user", content: "Hello" }],
  }),
});
const data = await r.json();
console.log(data.choices[0].message.content);

Стриминг

Streaming

Добавьте "stream": true — ответ чанками (SSE), как в OpenAI.

Set "stream": true for chunked SSE responses, OpenAI-style.

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

Изображения (vision)

Images (vision)

Картинка в messages в формате OpenAI (base64 или URL):

Pass an image in messages using OpenAI format (base64 or 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,..."}}
    ]
  }]
}

Публичные ссылки и веб-данные (ghostgpt.io)

Share links & web data (ghostgpt.io)

Эти ручки обслуживает сервис ghostgpt-tools на основном домене. Они не входят в /v1 OpenAI API.

These routes are served by ghostgpt-tools on the main site. They are not part of the OpenAI /v1 API.

Базовый URL: https://ghostgpt.io · Просмотр диалога: https://ghostgpt.io/share/{id}

Base URL: https://ghostgpt.io · View shared chat: https://ghostgpt.io/share/{id}

POST /api/share

POST /api/share

Тело — массив блоков диалога (как в UI). Максимум ~2 MB.

Body — array of conversation blocks (same shape as the UI). Max ~2 MB.

curl -X POST https://ghostgpt.io/api/share \
  -H "Content-Type: application/json" \
  -d '[{
    "conv": {"id": "example", "name": "My chat"},
    "messages": [
      {"role": "user", "content": "Hello", "timestamp": 1},
      {"role": "assistant", "content": "Hi!", "timestamp": 2}
    ]
  }]'

Ответ: {"id":"…","url":"https://ghostgpt.io/share/…"}

Response: {"id":"…","url":"https://ghostgpt.io/share/…"}

POST /api/fetch-url

POST /api/fetch-url

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

POST /api/web-research

POST /api/web-research

Для пар с рублем — ЦБ РФ и Банки.ру; для USD/TRY и др. — Frankfurter; погода — Яндекс.

RUB pairs use CBR + banki.ru; international FX uses Frankfurter; weather uses Yandex.

curl -X POST https://ghostgpt.io/api/web-research \
  -H "Content-Type: application/json" \
  -d '{"query": "курс доллара к рублю"}'

Просмотр документов (веб-UI)

Document preview (web UI)

Клик по вложению в чате открывает предпросмотр в браузере:

Click a chat attachment to preview in the browser:

• PDF — постранично (pdf.js), масштаб
• DOCX — HTML или текст (mammoth.js)
• XLSX/XLS/ODS/CSV — листы как таблицы (SheetJS)
• Текст для модели извлекается при загрузке; PDF также POST /api/pdf/extract

• PDF — paginated (pdf.js), zoom
• DOCX — HTML or text (mammoth.js)
• XLSX/XLS/ODS/CSV — sheets as tables (SheetJS)
• Model text is extracted on upload; PDF also via POST /api/pdf/extract

Статика: /gg-doc-viewer.js, /vendor/*.js

Assets: /gg-doc-viewer.js, /vendor/*.js

SDK и клиенты

SDKs & clients

Любой клиент с Custom OpenAI Base URL:

Any client with Custom OpenAI Base URL support:

• SDK openai (Python / Node) — Base URL https://api.ghostgpt.io/v1
• Любой OpenAI-совместимый HTTP-клиент

• openai SDK (Python / Node) — Base URL https://api.ghostgpt.io/v1
• Any OpenAI-compatible HTTP client

Веб-чат: ghostgpt.io

Web chat: ghostgpt.io

Ошибки

Errors

Лимиты

Limits & fair use

• Общий GPU — без массового парсинга и высокого QPS.
• Очень длинные диалоги замедляют ответ.
• Макс. тело запроса: ~100 MB (картинки в base64).

• Shared GPU — no bulk scraping or high QPS bots.
• Very long chats slow down responses.
• Max request body: ~100 MB (base64 images).