Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Schnelleinstieg für kostenlose APIs

Status: Aktiv Geltungsbereich: aktueller Stand Zuletzt geprüft: 2026-08-28 Verantwortlich: ax-code runtime

AX Code stellt kein Modellkontingent bereit. Ein „kostenloser“ Lauf nutzt Kontingent oder Guthaben eines externen Modellanbieters, dessen Verfügbarkeit, Grenzen, Datenbedingungen und Modellkatalog sich unabhängig von AX Code ändern können.

Kürzester unterstützter Weg: Groq

Groq ist ein voreingestellter Anbieter von AX Code, der aktuelle Modellkatalog von AX Code enthält werkzeugfähige Modelle, und Groq veröffentlicht Grenzen des Free Plan für diese Modellkennungen.

1. Legen Sie ein Groq-Konto und einen API-Schlüssel in der Groq Console an.
2. Speichern Sie den Schlüssel in AX Code:

ax-code providers login groq

3. Bestätigen Sie die Modelle, die in Ihrer installierten AX-Code-Version verfügbar sind:

ax-code models groq

4. Öffnen Sie ax-code, führen Sie /connect aus und wählen Sie Groq sowie eines der aufgeführten Modelle. Für eine kopflose Kurzprüfung unterstützt der aktuelle gebündelte Katalog:

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Wenn ax-code models groq genau dieses Modell nicht ausgibt, verwenden Sie eine Modellkennung, die ausgegeben wird. Der installierte Katalog ist für die installierte Version maßgeblich.

Eingebaute Optionen mit kostenlosem Kontingent oder Guthaben

Diese Anbieter stehen in der voreingestellten Einrichtungsauswahl von AX Code. „Eingebaut“ bedeutet, dass AX Code den Protokolladapter, die Modellmetadaten, den Ablauf für Zugangsdaten und den Anbieterendpunkt bereitstellt; es bedeutet nicht, dass jedes Modell oder jede Anfrage kostenlos ist.

Für UnoRouter verbinden Sie sich mit ax-code providers login unorouter, führen ax-code models unorouter aus und wählen ein Modell, dessen Kennung auf :free endet. Gehen Sie nicht davon aus, dass das kostenpflichtige Gegenstück ohne dieses Suffix kostenlos ist. Der eigene Katalog von UnoRouter vermerkt, dass nicht jedes kostenlose Modell Werkzeugaufrufe unterstützt; AX Code zeigt im gebündelten Katalog nur die werkzeugfähigen Einträge.

Für Google oder Hugging Face verbinden Sie sich mit der passenden Anbieterkennung und verwenden dann ax-code models google oder ax-code models huggingface. Prüfen Sie die aktuelle Preisseite des Anbieters, bevor Sie ein Modell wählen.

Den Router für kostenlose Modelle von OpenRouter hinzufügen

OpenRouter beschreibt openrouter/free als Router ohne Kosten, der ein verfügbares kostenloses Modell auswählt, das zur Anfrage passt. Weil dieser Router nicht im aktuellen gepflegten Snapshot von AX Code steht, fügen Sie einen konservativen lokalen Modelleintrag zur Datei ax-code.json im Stamm Ihres Projekts hinzu (oder führen Sie ihn in Ihre globale AX-Code-Konfiguration ein):

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

Die Grenzen oben sind konservative Budgetwerte von AX Code, kein Anspruch gegenüber OpenRouter. Verbinden Sie sich danach und prüfen Sie den zusammengeführten Modellkatalog:

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

Das wiederholte openrouter ist beabsichtigt: Das erste Segment ist die Anbieterkennung von AX Code, und openrouter/free ist die Modellkennung, die OpenRouter erwartet. Verfügbarkeit und Auswahl des kostenlosen Routers hängen von der Anfrage ab; siehe die Dokumentation des kostenlosen Routers von OpenRouter.

Den externen Katalog kostenloser APIs nutzen

awesome-free-llm-apis eignet sich, um aktuelle Angebote zu finden, ist aber keine Liste der Kompatibilität oder Empfehlung von AX Code:

• Ein Anbieter unter Unterstützte Anbieter und Modelle hat eine voreingestellte Einrichtung von AX Code.
• Ein Anbieter, der lediglich in models-snapshot.json vorkommt, ist durch das Register gestützt, aber nicht unbedingt für den voreingestellten Einrichtungsablauf gepflegt.
• Ein anderer Dienst kann über Eigene Anbieter und Gateways funktionieren, wenn er einen kompatiblen OpenAI- oder Anthropic-Endpunkt bereitstellt.
• „Mit OpenAI kompatibel“ ist notwendig, aber für einen Coding-Agenten nicht hinreichend. Das gewählte Modell braucht außerdem strömende Textantworten und zuverlässige Werkzeug- bzw. Funktionsaufrufe.
• Anbieternamen, Modellkennungen, kostenlose Kontingente, Regionen und Kontoanforderungen in Listen Dritter können veralten. Prüfen Sie sie anhand der offiziellen Seiten des Anbieters zu Preisen, Modellen und Ratengrenzen, bevor Sie sich darauf verlassen.

Zum Prüfungsdatum dieser Seite lassen sich die in diesem Katalog genannten Dienste AX Code so zuordnen:

Insbesondere ist die Voreinstellung github-copilot nicht die API github-models, die einige Kataloge aufführen. Ersetzen Sie nicht eine Anbieterkennung oder einen Ablauf für Zugangsdaten durch den anderen. Die allgemeinen APIs zai und zhipuai beginnen bei GLM-5.3; ältere SKUs von GLM 3, GLM 4, GLM-5 und GLM-5.2 bleiben herausgefiltert.

Sichere Bewertungspraxis

• Prüfen Sie zuerst mit einem öffentlichen oder wegwerfbaren Repository. Ein gehosteter Anbieter oder ein Gateway erhält die Prompts und den Codekontext, die an seine API gesendet werden.
• Aktivieren Sie die Isolation workspace-write oder verwenden Sie read-only für eine Kurzprüfung nur zur Durchsicht.
• Beginnen Sie mit einer kurzen Aufgabe und einem Agenten. Council, Arena, lange Sitzungen und große Repositorys können viele Anfragen verbrauchen und die Grenzen des kostenlosen Kontingents schnell erreichen.
• Speichern Sie Zugangsdaten mit ax-code providers login oder einer Umgebungsvariable; committen Sie API-Schlüssel niemals nach ax-code.json.
• Behandeln Sie 429 und vorübergehende Nichtverfügbarkeit als normale Grenzen eines kostenlosen Kontingents. Warten Sie auf das Wiederholungsfenster des Anbieters oder wählen Sie ein anderes derzeit aufgeführtes kostenloses Modell.