SubLaneSubLane

Native 클라이언트 프로토콜

SubLane 가이드: 기본 클라이언트 프로토콜.

이 엔드포인트는 다음을 도입했습니다. 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 전용입니다. 실제 공급자와 클라이언트는 별도로 검증해야 합니다.

Endpoints 및 인증

규약엔드포인트관련 상품
Claude 메시지POST /v1/messagesx-api-key 또는 Authorization: Bearer
Gemini JSONPOST /v1beta/models/{model}:generateContentx-goog-api-key, Authorization: Bearer, 또는 key 쿼리 매개 변수
Gemini SSEPOST /v1beta/models/{model}:streamGenerateContent?alt=sse같은 것과 Gemini JSON

자주 묻는 질문 SubLane API 키. 여러개의 자격이 공급된 경우, 그들은 동의해야 합니다. 잘못된 권한이 있는 권한이 있는 권한이 있는 권한이 있는 권한이 있는 경우, 브라우저 세션 쿠키는 관할권 자격 증명이 아닙니다. 다른 프록시가 URL을 로그할 수 있기 때문에 Prefer 헤더는 쿼리 문자열 키입니다. SubLane 클라이언트 키, 쿠키 또는 쿼리 문자열을 제공 업체에 전달하지 않습니다.

사용 GET /v1/models Bearer 인증으로 기본 모델 ID를 발견할 수 있습니다. Gemini 요청, URL의 모델은 권한; 몸 model 또는 stream 필드는 루트를 무시할 수 없습니다. streamGenerateContent 의논하기 SSE; alt omitted 또는 설정할 수 있습니다. sse.

Claude 이름 *

세트 SUBLANE_URL 인스턴스의 근원과 SUBLANE_API_KEY 당신의 개인 열쇠에. 대체하십시오 YOUR_MODEL_ID 카탈로그에서 모델:

Claude example · 1
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 이벤트. Native 요청 내용에는 시스템 블록, 도구, 도구 결과, 캐시 컨트롤 및 생각 구성이 포함됩니다. Claude- 정보 응답은 콘텐츠 블록 및 사고 서명을 보존하고 선택한 실행자의 제공 업체 별 취급에 따라합니다. 오류는 Anthropic 봉투를 사용하며 이름을 붙입니다. SSE 오류 이벤트. request-id 그리고 X-Request-ID 해당 요청 레코드를 식별합니다.

Gemini 이름 *

Gemini example · 2
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 envelope는 제거 SDK. 도구 호출 및 생각 서명은 그들의 체류 Gemini 표현. 오류는 Google-style을 사용 error.code, error.status 그리고 error.message. SSE 펑크가 있습니다. data: 없이 튀기 OpenAI₢ 킹 [DONE] 마커.

공유 행동

  • 회원 및 키, 키 만료, 풀 보조금, 모델 정책, 계정 가용성, 통화 및 회원 요청 제한은 기존 게이트웨이 서비스를 통해 다시 확인됩니다.
  • 모든 요청에서 키, 멤버, 리소스 그룹, 모델 정책, 용량과 멤버 제한을 확인합니다. 새 요청은 그룹 라우팅 및 대체 정책에 따라 구독 계정이나 API 채널을 사용합니다. 기존 대화는 원래 리소스에 연결되며 비활성화나 제거로 자동 전환되지 않습니다.
  • affinity 사용 Session_id; Claude 자주 묻는 질문 metadata.user_id 명시된 세션이 제공되지 않을 경우. Identifiers는 회원과 풀에 적용된다. 비공개 식별자가 없는 요청은 sessionless를 유지한다.
  • 취소는 업스트림 작업 및 릴리스 계정 / 회원 임대. 미스링 터미널 이벤트 및 변형 또는 대형 이벤트는 실패, 성공적인 빈 응답. 스트리밍 오류는 헤더가 전송 된 후 위생된다.
  • 견적의뢰 messages 또는 gemini요청 ID, 첫 출력 지연 및 사용 가능한 토큰 사용과 함께. Anthropic 입력 총은 캐시 읽기 및 생성을 포함합니다; Gemini 이미 캐시된 토큰을 포함하고, 그 출력 총은 사고 토큰을 포함합니다. Trailing Gemini 사용법 펑크는 후에 소모됩니다 finishReason.
  • 요청 본문의 기본 상한은 128 MiB(SUBLANE_MAX_REQUEST_BODY_MB)이며 응답 본문과 스트림 이벤트는 각각 8 MiB입니다. 전체 제한 시간은 기본 30분(SUBLANE_GATEWAY_REQUEST_TIMEOUT), 추론 응답 헤더 대기는 5분(SUBLANE_INFERENCE_HEADER_TIMEOUT)이며 네이티브 형식에도 적용됩니다. 스트림 응답은 순차 전달합니다.

통합된 초기화 스키마에는 요청 역사의 기본 프로토콜 작업이 포함되어 있습니다. 추가 영구적 인 서비스는 필요하지 않습니다.

범위 및 검증

이 합성 테스트 행렬은 Codex, Claude, Antigravity를 다루며 모두 런타임에서 활성화되어 있습니다. Grok Build와 API 채널도 활성화되어 있으며 이 24개 조합과는 별도의 테스트로 검증합니다.

클라이언트 프로토콜Codex 계좌정보Claude 계좌정보Antigravity 계좌정보
OpenAI Responses시험되는시험되는시험되는
OpenAI Chat Completions시험되는시험되는시험되는
Claude 메시지시험되는시험되는시험되는
Gemini 세대시험되는시험되는시험되는

TestClientProtocolMatrix는 모의 업스트림으로 공급자·프로토콜·스트림의 24개 조합을 검증합니다. Grok Build, API 채널, 서명, 캐시 사용량, 권한, 재시도, 취소와 잘못된 스트림은 별도 테스트로 다룹니다. 모든 도구, 추론 모드, 공급자 필드나 실제 클라이언트 작업 흐름의 호환성을 보증하지는 않습니다.

Coverage는 합성 계정과 모이는 공급자를, 기본을 포함하여 사용합니다 JSON/SSE, 도구/싱킹, 크로스 프로바이더 번역, 허가, 사용, 중단 및 취소. 그것은 완전 실제 계정 설정하지 않습니다 Claude 코드, Gemini CLI 또는 데스크톱 호환성. 고급 기본 기능은 선택한 공급자와 달려 있습니다. SDK 변환 경로.

으로 API 키 → 설정 가이드, 당신의 클라이언트를 선택하십시오 또는 API 형식. 가이드 제공 Codex 구성, Cline/OpenAI- 호환 설정 및 Chat Completions 예제, 또는 네이티브 Claude/Gemini 올바른 기본 URL 및 인증 헤더와 함께 요청 예제. 키의 풀에서 모델을 선택하십시오. 가이드는 열쇠의 비밀을 태치하지 않습니다; 예제 읽기 SUBLANE_API_KEY 클라이언트 환경에서. CC Switch 빠른 수입 지원하다 Codex, OpenCode, Claude 코드, OpenClaw, 헤르메스, Gemini CLI, 그리고 Grok Build.

Gemini CLI 0.37.2는 추가적으로 텍스트 스트리밍 요청과 합성 키 및 모델을 사용하여 격리 된 모호한 엔드 포인트에 대한 읽기 전용 도구 왕복을 완료했습니다. 이 체크는 CLI 요청 경로 및 응답 소비를 확인합니다. 실제 구독 인섭, 모든 CLI 기능 또는 기타 클라이언트의 전체 워크플로우를 유효하지 않습니다.

Token-count 엔드포인트, Message Batches, 파일, Gemini 라이브와 Antigravity 데스크톱 연결 프로토콜은이 변경에 의해 구현되지 않습니다. 지원되지 않은 작업은 세대 요청으로 처리되지 않습니다. 기본 모델 발견 리소스는 노출되지 않습니다; 풀스코프를 사용 /v1/models 카탈로그.

의정서 참고: Claude 관련 동영상, Claude 오류 수정, 그리고 Gemini 세대. Routing와 겸용성 경계는과 비교되었습니다 서브2api 그리고 의 새로운 API; SubLane 자체 허가, 수명주기 및 스토리지 구현을 유지합니다.

경영감사

SubLane 가이드: 경영 감사.

관리자 인증

SubLane 가이드: 관리자 인증입니다.