PROXAGY API · v2

Gemini в привычном
формате API.

Единый мультимодальный шлюз с интерфейсами OpenAI и Anthropic, постоянной историей, токенными лимитами и поддержкой coding CLI.

Начать за минуту →Интерактивный Explorer

BASE URLhttps://api.lndn.space

OpenAI compatibleChat Completions + Responses

Anthropic compatibleClaude Code + tool use

Direct streamingTTFT, tools, web search, usage

QUICKSTART

Первый запрос

Подставь свой ключ и отправь сообщение. Ответ приходит в OpenAI-совместимом формате.

Terminal

curl https://api.lndn.space/v1/chat/completions \
  -H "Authorization: Bearer pxg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.6-flash-high",
    "conversation_id": "my-first-chat",
    "messages": [
      {"role": "user", "content": "Привет! Объясни квантовую запутанность просто."}
    ]
  }'

Python · OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="pxg_live_...",
    base_url="https://api.lndn.space/v1",
)

response = client.chat.completions.create(
    model="gemini-3.6-flash-high",
    messages=[{"role": "user", "content": "Привет!"}],
    extra_body={"conversation_id": "my-first-chat"},
)
print(response.choices[0].message.content)

JavaScript · OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "pxg_live_...",
  baseURL: "https://api.lndn.space/v1",
});

const response = await client.chat.completions.create({
  model: "gemini-3.6-flash-high",
  messages: [{ role: "user", content: "Привет!" }],
  conversation_id: "my-first-chat",
});
console.log(response.choices[0].message.content);

Контекст сохраняется автоматическиПередавай одинаковый conversation_id и можешь отправлять только новое сообщение — Proxagy подставит предыдущую историю.

AUTHENTICATION

Авторизация

Каждый защищённый endpoint принимает один из двух вариантов заголовка.

Рекомендуется

Bearer token

Authorization: Bearer pxg_live_...

Альтернатива

API key header

X-API-Key: pxg_live_...

Ключ создаётся администратором и может иметь бюджет токенов, срок действия, лимит запросов в минуту, ограничение параллельности и список разрешённых моделей. Свой остаток пользователь видит в личном кабинете.

API REFERENCE

Endpoints

Основные маршруты. Полные схемы запросов доступны в API Explorer.

POST/v1/chat/completions

OpenAI Chat Completions, streaming и inline media.

POST/v1/responses

OpenAI Responses, previous_response_id, tools и настоящий SSE.

POST/v1/images/generations

Нативная генерация изображений с ответом URL или base64.

POST/v1/images/generations/async

Фоновая генерация: 202, Location и polling задачи.

POST/v1/messages

Anthropic Messages для Claude Code, tools и streaming.

POST/v1/conversations/{id}/messages

Multipart: до 100 МБ на файл и до 250 МБ на весь запрос.

POST/v1/conversations

Создать постоянный диалог с выбранной моделью.

GET/v1/conversations

Получить доступные ключу диалоги.

GET/v1/conversations/{id}

Диалог, сообщения и сохранённый контекст.

GET/v1/models

Модели, разрешённые для текущего ключа.

GET/health

Публичная проверка доступности шлюза.

Открыть интерактивные схемы и Try it out ↗

MODEL CATALOG

Доступные модели

Модель указывается в поле model. Конкретный ключ может быть ограничен allow-list.

IDПрофильКогда использовать

gemini-3.1-pro-highPro · HighСложный анализ и код

gemini-3.1-pro-lowPro · LowБыстрее и экономнее

gemini-3.6-flash-highFlash · HighОсновная быстрая модель

gemini-3.6-flash-mediumFlash · MediumБаланс скорости и качества

gemini-3.6-flash-lowFlash · LowПростые дешёвые задачи

gemini-3.5-flash-highFlash 3.5 · HighСовместимость с Flash 3.5

gemini-3.5-flash-mediumFlash 3.5 · MediumЭкономный профиль 3.5

gemini-3.5-flash-lowFlash 3.5 · LowМинимальный reasoning

proxagy-imageNative imageГенерация изображений

claude-proxagy-gemini-3.6-flash-highClaude aliasClaude Code и Anthropic clients

autoAutomaticМодель по умолчанию

PERSISTENT CONTEXT

История диалогов

Диалоги изолированы по API-ключам и хранятся на сервере.

1Создай IDНапример, telegram-12345

→

2Отправь сообщениеПередай его как conversation_id

→

3ПродолжайИстория подставится автоматически

Один ключ видит только созданные им диалоги. Содержимое сообщений не показывается в административном журнале расхода.

MULTIMODAL

Фото, аудио и документы

Передавай файлы через multipart либо inline content-массив OpenAI/Anthropic.

IMAGEAUDIOVOICEVIDEOPDFDOCUMENT

Multipart request

curl https://api.lndn.space/v1/conversations/telegram-123/messages \
  -H "Authorization: Bearer pxg_live_..." \
  -F "message=Что изображено и что говорится в голосовом?" \
  -F "files=@photo.jpg" \
  -F "files=@voice.ogg"

NATIVE IMAGE GENERATION

Генерация изображений

OpenAI-совместимый endpoint вызывает нативный инструмент Antigravity. На запрос создаётся одна картинка.

OpenAI Images · temporary URL

curl https://api.lndn.space/v1/images/generations   -H "Authorization: Bearer pxg_live_..."   -H "Content-Type: application/json"   -d '{
    "model": "proxagy-image",
    "prompt": "Уютный Лондон ночью, кинематографичный свет",
    "size": "1024x1024",
    "response_format": "url"
  }'

Подходит для Telegram-ботаВозьми data[0].url и передай URL в sendPhoto либо скачай файл. Ссылка действует 24 часа. Для долгой генерации используй /v1/images/generations/async, затем опрашивай URL из Location. Для данных прямо в JSON используй response_format: "b64_json".

Для OpenCode и других chat-only клиентовДобавь модель proxagy-image, напиши /image рыжий кот в космосе либо сформулируй явную просьбу «сгенерируй изображение…» в обычной Gemini-модели. Chat Completions автоматически вызовет генератор и вернёт Markdown-превью, прямую ссылку и объект image.

CODING CLIENTS

Claude Code

Proxagy реализует Anthropic Messages, streaming, tool calls и token counting.

Current terminal session

export ANTHROPIC_BASE_URL="https://api.lndn.space"
export ANTHROPIC_AUTH_TOKEN="pxg_live_..."
export ANTHROPIC_MODEL="claude-proxagy-gemini-3.6-flash-high"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_ATTRIBUTION_HEADER=0

claude --model "$ANTHROPIC_MODEL"

CODING CLIENTS

OpenCode

OpenAI-compatible provider поддерживает streaming usage, tool calls, запись файлов и команды проекта.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "proxagy/gemini-3.6-flash-high",
  "provider": {
    "proxagy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Proxagy Gemini",
      "options": {
        "baseURL": "https://api.lndn.space/v1",
        "apiKey": "pxg_live_...",
        "timeout": 600000
      },
      "models": {
        "gemini-3.6-flash-high": {
          "name": "Gemini 3.6 Flash High",
          "limit": { "context": 30000, "output": 8192 }
        },
        "proxagy-image": {
          "name": "Proxagy Image",
          "limit": { "context": 30000, "output": 8192 }
        }
      }
    }
  }
}

Инструменты выполняются на компьютере пользователяProxagy возвращает стандартные OpenAI tool_calls, а OpenCode показывает и выполняет write, edit, bash и другие доступные инструменты в выбранной рабочей папке. Финальный streaming chunk содержит input/output/total, cache и reasoning token details.

ERROR HANDLING

Коды ошибок

Ответы об ошибках возвращаются в JSON с полем detail.

400Некорректный запрос или неподдерживаемая модель

401Ключ отсутствует или недействителен

402Токенный бюджет закончился

403Ключ приостановлен, истёк или модель запрещена

429Превышен RPM либо параллельный лимит

502Временная ошибка backend-модели

Gemini в привычномформате API.

Первый запрос

Авторизация

Bearer token

API key header

Endpoints

Доступные модели

История диалогов

Фото, аудио и документы

Генерация изображений

Claude Code

OpenCode

Коды ошибок

Gemini в привычном
формате API.