Нативные клиентские протоколы

Эти конечные точки были введены после v0.1.0-rc.1; этот выпуск не включает их. Используйте сборку источника до тех пор, пока более новый выпуск не включает это изменение.

Доступны подписки Codex, Claude, Antigravity и Grok Build и каналы API. Claude Messages, Gemini, Responses и Chat Completions — независимые от провайдера клиентские форматы. Ресурс выбирается по поддержке модели, группе ключа, правам и правилам маршрутизации и резервирования. Канал API задаёт собственный протокол: Messages может остаться нативным или преобразоваться в Chat Completions, Responses либо Gemini. Публичная интеграция SDK сохраняет явные лимиты вывода и незавершённый статус. /v1/responses/compact доступен только Codex. Реальные провайдеры и клиенты проверяются отдельно.

Конечные точки и аутентификация

Используйте персональный SubLane API Ключ. Если предоставлено несколько локаций учетных данных, они должны согласиться; недействительный заголовок авторизации не может вернуться к другому ключу. Файлы cookie сеанса браузера не являются учетными данными шлюза. Предпочитают заголовки ключам строки запроса, потому что другие прокси могут регистрировать URL-адреса. SubLane не пересылает клиентские ключи, файлы cookie или строки запросов поставщикам.

Использовать GET /v1/models с аутентификацией на предъявителя для обнаружения разрешенных идентификаторов нативной модели. Gemini запросы, модель в URL является авторитетной; model или stream Поле не может пересечь маршрут. streamGenerateContent возвращение SSE; alt может быть опущен или установлен на sse.

Claude пример

Настройка SUBLANE_URL В случае происхождения и SUBLANE_API_KEY Замените свой личный ключ. YOUR_MODEL_ID с моделью из каталога:

curl "$SUBLANE_URL/v1/messages" \
  -H "x-api-key: $SUBLANE_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'content-type: application/json' \
  --data '{"model":"YOUR_MODEL_ID","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

Добавить "stream": true Для именованных сообщений SSE Нативный контент запроса включает в себя системные блоки, инструменты, результаты инструментов, элементы управления кэшем и конфигурацию мышления. Claude-форматные ответы сохраняют блоки контента и мыслящие подписи при условии, что выбранный исполнитель обрабатывается с помощью конкретного провайдера. Ошибки используют конверт Anthropic и называются SSE Ошибочные события. request-id и X-Request-ID идентифицировать соответствующую запись запроса.

Gemini пример

curl "$SUBLANE_URL/v1beta/models/YOUR_MODEL_ID:generateContent" \
  -H "x-goog-api-key: $SUBLANE_API_KEY" \
  -H 'content-type: application/json' \
  --data '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'

Для потоковой передачи, использовать :streamGenerateContent?alt=sse и curl --no-buffer. Responses содержать родной candidatesчасти и usageMetadata; AntigravityВнутренний response конверт удаляется с помощью SDKЗвонки с инструментами и мыслительные подписи остаются в их Gemini Ошибки в стиле Google error.code, error.status и error.message. SSE куски имеют data: обрамление без OpenAI? [DONE] Маркер.

Совместное поведение

• Включенные члены и ключи, истечение срока действия ключа, права доступа пула, типовые политики, доступность учетной записи, параллелизм и лимиты запросов участников перепроверяются через существующие шлюзовые службы.
• Каждый запрос проверяет ключ, участника, группу ресурсов, политику моделей, ёмкость и лимиты участника. Новые запросы используют подписки или каналы API согласно маршрутизации и резервному переходу группы. Существующие диалоги сохраняют привязку к ресурсу; отключение или удаление не вызывает автоматического переключения.
• Аффинити разговора использует Session_id; Claude также использует metadata.user_id когда нет явного сеанса. Идентификаторы подведены к члену и пулу. Запросы без идентификатора аффинности остаются без сеанса.
• Отмена закрывает работу по потоку и освобождает счета / лизинг участников. Пропущенные события терминала и несовершенные или негабаритные события являются сбоями, а не успешными пустыми ответами. Потоковые ошибки дезинфицируются после отправки заголовков.
• Запрос истории маркирует операции как messages или geminiс идентификаторами запросов, задержкой первого выхода и доступным использованием токенов. Общие значения антропного ввода включают считывание кэша и создание; Gemini Вход уже включает в себя кэшированные токены, а его выходная сумма включает в себя мыслящие токены. Gemini Потребляемые куски потребляются после finishReason.
• Размер тела запроса по умолчанию ограничен 128 MiB (SUBLANE_MAX_REQUEST_BODY_MB), ответа и отдельного события — 8 MiB. Общий срок запроса составляет 30 минут (SUBLANE_GATEWAY_REQUEST_TIMEOUT), ожидание заголовков ответа модели — пять минут (SUBLANE_INFERENCE_HEADER_TIMEOUT), в том числе для нативных протоколов. Потоковые ответы передаются постепенно.

Консолидированная схема инициализации включает в себя нативные протокольные операции в истории запросов.

Сфера охвата и проверка

Эта синтетическая матрица охватывает Codex, Claude и Antigravity: все они включены при выполнении. Grok Build и каналы API также включены и проверяются отдельными тестами, вне этих 24 комбинаций:

TestClientProtocolMatrix проверяет 24 сочетания провайдера, протокола и потокового режима на имитациях сервисов. Отдельные тесты охватывают Grok Build, каналы API, подписи, кеш, права, повторы, отмену и некорректные потоки. Они не подтверждают совместимость всех инструментов, режимов рассуждения, полей провайдера и сценариев реальных клиентов.

Охват использует синтетические учетные записи и высмеиваемых поставщиков, в том числе нативных. JSON/SSE, инструменты/мышление, кросс-провайдерский перевод, авторизация, использование, прерывание и аннулирование. Claude Код, Gemini CLI или совместимость с рабочим столом. Расширенные нативные функции зависят от выбранного поставщика и SDK Путь преобразования.

в API Ключи → Руководство по настройкеВыберите своего клиента или API Формат. Руководство предусматривает Codex конфигурация, Cline/OpenAI-совместимая установка и Chat Completions Примеры или родные Claude/Gemini запросить примеры с правильным базовым URL и заголовком аутентификации. Выберите модель из пула ключей. Руководство никогда не извлекает секрет ключа; примеры читать SUBLANE_API_KEY из клиентской среды. CC Switch Быстрый импорт поддержка CodexOpenCode, Claude Код, OpenClaw, Гермес, Gemini CLI, и Grok Build.

Gemini CLI 0.37.2 дополнительно выполнил запрос на потоковое воспроизведение текста и круглое путешествие только для чтения с изолированной макетной конечной точкой с использованием синтетического ключа и модели. Это проверяет путь запроса CLI и потребление ответа; это не подтверждает вывод о реальной подписке, каждую функцию CLI или полные рабочие процессы других клиентов.

Конечные точки счета токенов, пакеты сообщений, файлы, Gemini Жить и Antigravity Протоколы подключения настольных компьютеров не реализуются в результате этого изменения. Неподдерживаемые действия отвергаются, а не рассматриваются как запросы на генерацию. Нативные ресурсы обнаружения моделей не подвергаются воздействию; используйте скопированные пулы /v1/models Каталог.

Ссылки на протокол: Claude потоковый, Claude ошибкии Gemini поколениеГраницы маршрутизации и совместимости сравнивались с sub2api и Новый API; SubLane сохраняет свое собственное разрешение, жизненный цикл и реализацию хранения.