1. Kern-Integrationsmuster
1.1 Einheitliche Authentifizierung und Routing
- TypeScript
- Python
1.2 Besondere Behandlungspunkte
- Empty-Tools-Fix: Wenn
tools=[]undtool_choicevorhanden ist, entfernen Sietool_choiceautomatisch - Dateiendungen: Setzen Sie die richtigen Dateiendungen automatisch basierend auf
mediaType - Cache-Steuerung: Unterstützt
<cache>-Tags zur Cache-Steuerung
2. Einheitliche Integration
2.1 Kern-Client-Wrapper
- TypeScript
- Python
2.2 Spezielle Behandlung und Hilfsfunktionen
- TypeScript
- Python
3. Deployment und Konfiguration
3.1 Umgebungsvariablen
- TypeScript
- Python
3.2 Fehlerbehandlung
- TypeScript
- Python
4. Referenzimplementierungen und Abgleich-Checkliste
4.1 cherry-studio-Client-Referenz (TypeScript)
Die folgenden Kernpunkte auscherry-studio’s AihubmixAPIClient.ts können als Vorlage für Drittanbieter-Frontend- bzw. Desktop-Anwendungen dienen, die aihubmix auf TypeScript-Seite integrieren:
- Einheitliches Hinzufügen des Rabatt-Codes:
extra_headersauf Provider-Ebene zusammenführen undAPP-Codesetzen (im Projekt wirdMLTG2087verwendet) - Multi-Client-Routing:
claude*→ Anthropic-Client verwendengemini*/imagen*, die nicht auf-nothink/-searchenden und keinembeddingenthalten → Gemini-Client verwenden (apiHost: https://aihubmix.com/gemini)- OpenAI-Serie (außer
gpt-oss) → OpenAI-kompatibler Response-Client - Sonstige → Fallback auf den Standard-OpenAI-Client
- BaseURL-Ermittlung: aus dem aktuell gerouteten Client exportieren, um Endpoint-Unterschiede pro Anbieter zu erhalten
4.2 dify-plugin-aihubmix-Referenz (Python)
Die folgenden Kernpunkte aus derdify-plugin-aihubmix-Implementierung können als Vorlage für Drittanbieter-Python-Tools dienen, die aihubmix integrieren:
- Einheitliches Hinzufügen des Rabatt-Codes:
extra_headersauf Provider-Ebene zusammenführen undAPP-Codesetzen (im Projekt wirdDify2025verwendet) - Multi-Client-Routing:
claude*→ Anthropic-Client verwendengemini*/imagen*, die nicht auf-nothink/-searchenden und keinembeddingenthalten → Gemini-Client verwenden (apiHost: https://aihubmix.com/gemini)- OpenAI-Serie (außer
gpt-oss) → OpenAI-kompatibler Response-Client - Sonstige → Fallback auf den Standard-OpenAI-Client
- BaseURL-Ermittlung: aus dem aktuell gerouteten Client exportieren, um Endpoint-Unterschiede pro Anbieter zu erhalten
4.3 Abgleich-Checkliste
- Provider-Eintrag vereinheitlicht das Zusammenführen von
extra_headersund injiziertAPP-Code - Gemini-Client verwendet
https://aihubmix.com/geminialsapiHost - Routing-Regeln sind konsistent für
claude*,gemini*/imagen*, OpenAI-Serie (außergpt-oss) - Standard-Fallback auf OpenAI-Client unter Beibehaltung des OpenAI-kompatiblen Verhaltens
getBaseURL()exportiert immer aus dem aktuell gerouteten Client, ohne Hardcoding
5. Migrationsprüfliste
- API-Schlüssel durch aihubmix-API-Schlüssel ersetzen
- Base URL durch
https://aihubmix.comersetzen - Header
APP-Codefür den Rabatt hinzufügen - Modell-Routing-Logik implementieren (claude/gemini/openai)
tool_choice-Fix bei leeremtoolsbehandeln- MIME-Type-Behandlung für File-Uploads konfigurieren
- Verschiedene Modellaufrufe testen
Zuletzt aktualisiert: 2026-06-01