Native Client Protokolle

Diese Endpunkte wurden nach v0.1.0-rc.1Verwenden Sie einen Source Build, bis ein neueres Release diese Änderung enthält.

Codex-, Claude-, Antigravity- und Grok-Build-Abonnements sowie API-Kanäle sind aktiviert. Claude Messages, Gemini, Responses und Chat Completions sind vom Anbieter unabhängige Clientformate. Modellfähige Ressourcen werden nach Schlüsselgruppe, Berechtigungen und Routing-/Rückfallregeln gewählt. API-Kanäle konfigurieren ihr eigenes Upstream-Protokoll: Messages kann nativ bleiben oder in Chat Completions, Responses oder Gemini umgewandelt werden. Die öffentliche SDK-Integration erhält explizite Ausgabelimits und unvollständige Zustände. /v1/responses/compact bleibt Codex vorbehalten. Reale Anbieter und Clients erfordern separate Prüfungen.

Endpunkte und Authentifizierung

Verwenden Sie ein persönliches SubLane API Schlüssel. Wenn mehrere Anmeldestellen angegeben werden, müssen sie zustimmen; ein ungültiger Autorisierungs-Header kann nicht auf einen anderen Schlüssel zurückgreifen. Browser-Sitzungs-Cookies sind keine Gateway-Anmeldeinformationen. Bevorzugt Header zu Abfragezeichenfolgen-Schlüsseln, da andere Proxies URLs protokollieren können. SubLane keine Client-Schlüssel, Cookies oder Abfragezeichenfolgen an Anbieter weiterleitet.

Verwendung GET /v1/models mit Bearer-Authentifizierung, um zulässige native Modell-IDs zu finden. Gemini Requests, das Modell in der URL ist autoritativ; ein Körper model oder stream Das Feld kann die Route nicht überschreiben. streamGenerateContent Rücksendungen SSE; alt kann weggelassen oder eingestellt werden auf sse.

Claude Beispiel

Setz SUBLANE_URL zur Instanz origin und SUBLANE_API_KEY zu Ihrem persönlichen Schlüssel. Ersetzen YOUR_MODEL_ID mit einem Modell aus dem Katalog:

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"}]}'

Additiv "stream": true für benannte Nachrichten SSE Native Request-Inhalte umfassen Systemblöcke, Tools, Tool-Ergebnisse, Cache-Steuerelemente und Denkkonfiguration. Claude-format-Antworten bewahren Inhaltsblöcke und Denksignaturen, vorbehaltlich der anbieterspezifischen Handhabung des ausgewählten Executors. SSE Fehlerereignisse. request-id und X-Request-ID Identifizieren des entsprechenden Anforderungsprotokolls.

Gemini Beispiel

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"}]}]}'

Für Streaming, Verwendung :streamGenerateContent?alt=sse und curl --no-buffer. Responses Enthalten native candidates, Teile und usageMetadata; Antigravity's intern response Der Umschlag wird durch die SDKWerkzeuganrufe und Gedankensignaturen bleiben in ihren Gemini Darstellung. Fehler verwenden Google-Stil error.code, error.status und error.message. SSE Brocken haben data: Framing ohne OpenAI's [DONE] Markierung.

Gemeinsames Verhalten

• Aktivierte Mitglieder und Schlüssel, Schlüsselablauf, Pool-Zugriffsrechte, Modellrichtlinien, Kontoverfügbarkeit, Parallelität und Mitgliederanforderungslimits werden über die vorhandenen Gateway-Dienste erneut überprüft.
• Jede Anfrage prüft Schlüssel, Mitglied, Ressourcengruppe, Modellrichtlinie, Kapazität und Mitgliedslimits. Neue Anfragen können gemäß Routing und Rückfallregeln Abonnements oder API-Kanäle verwenden. Bestehende Gespräche behalten ihre Ressource; Deaktivierung oder Entfernung löst keinen automatischen Wechsel aus.
• Verwendung von Konversationsaffinität Session_id; Claude auch Verwendungen metadata.user_id wenn keine explizite Sitzung geliefert wird. Identifikatoren werden auf das Mitglied und den Pool übertragen. Anfragen ohne Affinitätskennung bleiben sitzungslos.
• Die Stornierung schließt vorgelagerte Arbeiten und gibt Konto-/Mitgliederleasing frei. Fehlende Terminal-Ereignisse und fehlerhafte oder übergroße Ereignisse sind Ausfälle, keine erfolgreichen leeren Antworten. Streaming-Fehler werden nach dem Versenden von Headern bereinigt.
• Request History Labels Operationen als messages oder gemini, mit Request-IDs, First-Output-Latenz und verfügbare Token-Nutzung; anthropische Eingabesummen umfassen Cache-Reads und Erstellung; Gemini Input enthält bereits zwischengespeicherte Token, und seine Ausgabesumme enthält Denktoken. Gemini Gebrauchsstücke werden verbraucht, nachdem finishReason.
• Anfragekörper sind standardmäßig auf 128 MiB begrenzt (SUBLANE_MAX_REQUEST_BODY_MB), Antworten und Stream-Ereignisse jeweils auf 8 MiB. Das Gesamtzeitlimit beträgt 30 Minuten (SUBLANE_GATEWAY_REQUEST_TIMEOUT), die Wartezeit auf Inferenz-Antwortheader fünf Minuten (SUBLANE_INFERENCE_HEADER_TIMEOUT), auch bei nativen Protokollen. Streams werden schrittweise weitergeleitet.

Das konsolidierte Initialisierungsschema enthält native Protokolloperationen in der Anforderungshistorie, es ist kein zusätzlicher persistenter Dienst erforderlich.

Anwendungsbereich und Überprüfung

Diese synthetische Matrix deckt Codex, Claude und Antigravity ab; alle sind zur Laufzeit aktiviert. Grok Build und API-Kanäle sind ebenfalls aktiviert und separat getestet, außerhalb dieser 24 Fälle:

TestClientProtocolMatrix prüft 24 Anbieter-/Protokoll-/Stream-Kombinationen mit simulierten Gegenstellen. Separate Tests decken Grok Build, API-Kanäle, Signaturen, Cache-Nutzung, Berechtigungen, Wiederholungen, Abbruch und fehlerhafte Streams ab. Sie bestätigen nicht jedes Werkzeug, jeden Denkmodus, jedes Anbieterfeld oder jeden Ablauf mit realen Clients.

Coverage verwendet synthetische Konten und verspottete Anbieter, einschließlich nativer Anbieter JSON/SSE, Werkzeuge/Denken, anbieterübergreifende Übersetzung, Autorisierung, Nutzung, Unterbrechung und Stornierung. Claude Code, Gemini CLI- oder Desktop-Kompatibilität. Erweiterte native Funktionen hängen vom ausgewählten Anbieter und SDK Konversionspfad.

In API Keys → Setup GuideWählen Sie Ihren Client oder API Format. Der Leitfaden bietet Codex Konfiguration, Cline/OpenAI-kompatibles Setup und Chat Completions Beispiele oder native Claude/Gemini Beispiele anfordern, mit der richtigen Basis-URL und Authentifizierungs-Header, ein Modell aus dem Schlüsselpool auswählen, das Handbuch nie das Geheimnis eines Schlüssels herausholen, Beispiele lesen SUBLANE_API_KEY aus dem Kundenumfeld. CC Switch Schnelle Einfuhr Stützen Codex, OpenCode Claude Code, OpenClaw, Hermes, Gemini CLI und Grok Build.

Gemini CLI 0.37.2 hat zusätzlich eine Text-Streaming-Anfrage und eine Read-Only-Tool-Roundtrip mit einem isolierten Mock-Endpunkt unter Verwendung eines synthetischen Schlüssels und Modells abgeschlossen, wodurch der CLI-Anfragepfad und -Antwortverbrauch überprüft werden; es validiert nicht die Inferenz von echten Abonnements, jede CLI-Funktion oder die vollständigen Workflows der anderen Clients.

Token-Count-Endpunkte, Nachrichtenbatches, Dateien, Gemini Lebend und Antigravity Desktop-Verbindungsprotokolle werden durch diese Änderung nicht implementiert; nicht unterstützte Aktionen werden abgelehnt und nicht als Generierungsanforderungen behandelt; native Modell-Entdeckungsressourcen werden nicht bereitgestellt; /v1/models Katalog.

Referenzprotokolle: Claude Streaming, Claude Fehler, und Gemini GenerationRouting- und Kompatibilitätsgrenzen wurden verglichen mit Sub2api und Neu API; SubLane behält seine eigene Erlaubnis, Lifecycle und Storage-Implementierung.