Zum Hauptinhalt springen

1. Kern-Integrationsmuster

1.1 Einheitliche Authentifizierung und Routing

1.2 Besondere Behandlungspunkte

  • Empty-Tools-Fix: Wenn tools=[] und tool_choice vorhanden ist, entfernen Sie tool_choice automatisch
  • 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

2.2 Spezielle Behandlung und Hilfsfunktionen

3. Deployment und Konfiguration

3.1 Umgebungsvariablen

3.2 Fehlerbehandlung

4. Referenzimplementierungen und Abgleich-Checkliste

4.1 cherry-studio-Client-Referenz (TypeScript)

Die folgenden Kernpunkte aus cherry-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_headers auf Provider-Ebene zusammenführen und APP-Code setzen (im Projekt wird MLTG2087 verwendet)
  • Multi-Client-Routing:
    • claude* → Anthropic-Client verwenden
    • gemini*/imagen*, die nicht auf -nothink/-search enden und kein embedding enthalten → 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 der dify-plugin-aihubmix-Implementierung können als Vorlage für Drittanbieter-Python-Tools dienen, die aihubmix integrieren:
  • Einheitliches Hinzufügen des Rabatt-Codes: extra_headers auf Provider-Ebene zusammenführen und APP-Code setzen (im Projekt wird Dify2025 verwendet)
  • Multi-Client-Routing:
    • claude* → Anthropic-Client verwenden
    • gemini*/imagen*, die nicht auf -nothink/-search enden und kein embedding enthalten → 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_headers und injiziert APP-Code
  • Gemini-Client verwendet https://aihubmix.com/gemini als apiHost
  • Routing-Regeln sind konsistent für claude*, gemini*/imagen*, OpenAI-Serie (außer gpt-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.com ersetzen
  • Header APP-Code für den Rabatt hinzufügen
  • Modell-Routing-Logik implementieren (claude/gemini/openai)
  • tool_choice-Fix bei leerem tools behandeln
  • MIME-Type-Behandlung für File-Uploads konfigurieren
  • Verschiedene Modellaufrufe testen

Zuletzt aktualisiert: 2026-06-01