API-Anleitung

Claude Code, Cline oder jedes SDK mit AIGROW-Guthaben einrichten

Eine kurze, einfache Einrichtung für den AIGROW-Endpunkt. Code einlösen, Schlüssel erstellen, ein beliebiges OpenAI- oder Anthropic-kompatibles Tool auf die Basis-URL ausrichten und eine Anfrage senden. Ein SDK von uns müssen Sie nicht installieren.

Funktioniert mit Claude Code, Cline, Aider, OpenCode, Zed, den SDKs von OpenAI und Anthropic sowie curl.

Der AIGROW-API-Endpunkt ist ein direkter Ersatz für die APIs von OpenAI und Anthropic. Verwenden Sie https://aigrow.gg als Anthropic-Basis-URL oder https://aigrow.gg/v1 als OpenAI-Basis-URL, authentifizieren Sie sich mit Ihrem ag_-Schlüssel und senden Sie die exakte Modell-ID aus dem Katalog. Das Guthaben erhalten Sie, indem Sie den Code von Ihrem Beleg im Dashboard einlösen.

Einrichtung mit einem KI-Agenten

Die meisten übergeben das an einen Coding-Agenten. Fügen Sie den Block in Claude Code, Cursor, Cline oder einen anderen Agenten ein, dann konfiguriert er sich selbst. Ersetzen Sie anschließend den Schlüssel durch Ihren eigenen.

AIGROW API gateway: an OpenAI- and Anthropic-compatible endpoint.
Configure a client with ONE of these two wires. The key starts with ag_.

Anthropic wire
  base URL   https://aigrow.gg            (the SDK appends /v1/messages)
  header     x-api-key: ag_your_key_here  (or Authorization: Bearer ag_your_key_here)
  header     anthropic-version: 2023-06-01
  body       max_tokens is required on every request

OpenAI wire
  base URL   https://aigrow.gg/v1         (POST /chat/completions)
  header     Authorization: Bearer ag_your_key_here

Model ids: claude-opus-5.5, claude-fable-5.1, gpt-6-astra, claude-sonnet-5.5, gpt-6.1-sol, grok-4.7
The provider's own spellings work too (claude-opus-5-5, anthropic/claude-opus-5.5).
A date suffix or any other model is rejected with 404 "Unknown model" before
the request is forwarded, and nothing is billed.
Claude Code: also set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5.5, since its
background calls default to a Haiku model the endpoint does not serve.
Call GET /v1/models with the key for the live list of ids.

Endpoints: POST /v1/messages (Anthropic), POST /v1/chat/completions (OpenAI),
GET /v1/models. Streaming is supported on both wires.
Capacity: about 20 requests per minute and 4 in flight, shared. Past it a
request gets 429 with a retry-after header; wait that long and send it again.
Full guide: https://aigrow.gg/ai-api/guide

Er enthält beide Protokolle, die Header-Namen, die Regel zur exakten ID und die Limits, also alles, was ein Agent beim ersten Versuch falsch macht.

Code einlösen

Dies ist der einzige Schritt, der nur bei AIGROW vorkommt. Er dauert weniger als eine Minute.

Im Dashboard anmeldenÖffnen Sie aigrow.gg/dashboard und melden Sie sich an, oder erstellen Sie ein Konto mit einer beliebigen E-Mail-Adresse. Der Code ist nicht an die Adresse gebunden, mit der Sie bezahlt haben.1 Minute
Code einfügenGehen Sie zu API-Zugang, fügen Sie den Code aus Ihrer Einlöse-E-Mail unter „Code einlösen“ ein, und Ihr Guthaben wird sofort aktualisiert.Sofort
Schlüssel erstellenErstellen Sie anschließend, ebenfalls unter API-Zugang, einen Schlüssel. Er beginnt mit ag_ und wird nur einmal angezeigt, kopieren Sie ihn daher direkt in Ihr Tool.Wird einmal angezeigt

Die zwei Dinge, die jedes Tool braucht

Eine Basis-URL und Ihren Schlüssel. Wählen Sie die Basis-URL, die zu Ihrem Tool passt.

Anthropic-Basis-URL

Für Claude Code, Claude Desktop und das Anthropic-SDK.

https://aigrow.gg
OpenAI-Basis-URL

Für Cline, Aider, OpenCode, das OpenAI-SDK und die meisten anderen Tools.

https://aigrow.gg/v1

Senden Sie die Modell-ID genau so, wie der Katalog sie aufführt, zum Beispiel claude-opus-5.5. In der Preisliste finden Sie alle IDs und ihre Kosten, oder rufen Sie GET /v1/models mit Ihrem Schlüssel auf, um die aktuelle Liste zu erhalten.

Tool verbinden

Jedes Tool hat eine eigene Seite: der genaue Block, wohin er gehört, welche Modell-ID Sie senden müssen und was die einzelnen Fehler bedeuten.

  • Claude CodeAnthropic-Protokoll

    Vier Umgebungsvariablen, in der Shell oder in der settings.json.

  • ClineOpenAI-Protokoll

    Der Anbieter OpenAI Compatible, vier Felder im Einstellungsbildschirm.

  • Roo CodeOpenAI-Protokoll

    Der Provider OpenAI Compatible, mit denselben Feldern wie bei Cline.

  • Kilo CodeOpenAI-Protokoll

    Ein eigener Provider im Tab Providers; die Modellliste füllt sich von selbst.

  • ContinueOpenAI-Protokoll

    Ein models-Eintrag in config.yaml mit provider openai und einer apiBase.

  • AiderOpenAI-Protokoll

    OPENAI_API_BASE und OPENAI_API_KEY, dann openai/ vor der Modell-ID.

  • OpenCodeOpenAI-Protokoll

    Ein Provider-Block in opencode.json und der Schlüssel über /connect.

  • ZedAnthropic- und OpenAI-Protokoll

    Ein Anthropic-kompatibler Provider für Claude, ein OpenAI-kompatibler für GPT und Grok.

  • GooseOpenAI-Protokoll

    Der OpenAI-Provider mit OPENAI_HOST oder eine eigene Provider-Datei.

  • Vercel AI SDKAnthropic- und OpenAI-Protokoll

    Der OpenAI-Compatible-Anbieter für jedes Modell oder der Anthropic-Anbieter für Claude.

  • OpenAI Agents SDKOpenAI-Protokoll

    Ihr eigener AsyncOpenAI-Client, auf Chat Completions umgestellt und mit deaktiviertem Tracing.

  • LangChainAnthropic- und OpenAI-Protokoll

    ChatOpenAI mit base_url für jedes Modell oder ChatAnthropic für Claude.

Die SDKs und curl

Kopieren Sie den Block und ersetzen Sie den Schlüssel durch Ihren eigenen.

OpenAI SDK (Python)

Setzen Sie base_url und api_key, wenn Sie den Client erstellen.

from openai import OpenAI

client = OpenAI(
    base_url="https://aigrow.gg/v1",
    api_key="ag_your_key_here",
)

resp = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Anthropic SDK (Python)

Setzen Sie base_url und api_key, wenn Sie den Client erstellen.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://aigrow.gg",
    api_key="ag_your_key_here",
)

msg = client.messages.create(
    model="claude-opus-5.5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

curl (OpenAI)

Eine erste Anfrage über die Kommandozeile, um zu prüfen, ob der Schlüssel funktioniert.

curl https://aigrow.gg/v1/chat/completions \
  -H "Authorization: Bearer ag_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

curl (Anthropic)

Dieselbe Anfrage über das Anthropic-Protokoll.

curl https://aigrow.gg/v1/messages \
  -H "x-api-key: ag_your_key_here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Mit dem Vercel AI SDK, dem OpenAI Agents SDK oder LangChain? Jedes braucht eine weitere Einstellung, um bei Chat Completions zu bleiben, und auf der jeweiligen Seite steht der passende Block dazu.

Endpunkte und Limits

Dieselben Pfade wie bei den offiziellen APIs, mit einer gemeinsamen Obergrenze für den Datenverkehr.

Endpunkte

Senden Sie Anfragen an diese Pfade.

POST /v1/messages          (Anthropic)
POST /v1/chat/completions  (OpenAI)
GET  /v1/models            (list the model ids)
Rate-Limits

Gemeinsam für alle am Endpunkt.

20 requests / minute
4 requests in flight at once

Beim Anthropic-Protokoll muss jede Anfrage max_tokens enthalten. Streaming funktioniert bei beiden Protokollen, und eine gestreamte Anfrage kostet genauso viel wie eine nicht gestreamte.

Guthaben im Blick behalten

Jede Anfrage wird zum veröffentlichten Preis ihres Modells abgerechnet und von Ihrem Guthaben abgebucht.

Die Seite API-Zugang zeigt Ihr Guthaben, Ihre Schlüssel und ein Aktivitätsprotokoll mit Modell und Kosten jeder Anfrage, sodass Sie Ihr Guthaben nie schätzen müssen. Wird es knapp, lösen Sie einen weiteren Code ein oder kaufen ein Paket. Das Guthaben wird demselben Konto gutgeschrieben, und alle Schlüssel funktionieren weiter.

Wenn etwas nicht funktioniert

Die wenigen Stolpersteine und jeweils die Lösung in einem Satz.

Der Schlüssel fehlt oder ist falsch eingegeben. Kopieren Sie ihn erneut unter API-Zugang im Dashboard und achten Sie darauf, dass er als Schlüssel gesendet wird, nicht als Modellname. Ein widerrufener Schlüssel führt zum gleichen Fehler: Erstellen Sie einen neuen und tauschen Sie ihn aus.

Ihr Guthaben ist aufgebraucht. Öffnen Sie im Dashboard den API-Zugang, lösen Sie einen Code ein oder kaufen Sie ein weiteres Paket, dann geht die nächste Anfrage durch. Weitere Änderungen sind nicht nötig.

Das Modell muss eines sein, das der Endpunkt bereitstellt, zum Beispiel claude-opus-5.5. Die Schreibweisen des Anbieters funktionieren ebenfalls (claude-opus-5-5, anthropic/claude-opus-5.5), aber eine ID mit Datum oder ein Modell außerhalb des Katalogs wird abgelehnt, bevor die Anfrage weitergeleitet wird, und es wird nichts berechnet. Rufen Sie GET /v1/models mit Ihrem Schlüssel auf, um die aktuelle Liste zu erhalten, oder lesen Sie die IDs in der Preisliste nach.

Beim Anthropic-Protokoll (/v1/messages) muss jede Anfrage max_tokens enthalten. Fügen Sie es hinzu, zum Beispiel "max_tokens": 512, dann geht die Anfrage durch. Das OpenAI-Protokoll verlangt es nicht.

Die Kapazität des Endpunkts teilen sich alle Kunden: etwa 20 Anfragen pro Minute und 4 gleichzeitig. Jede 429-Antwort enthält einen retry-after-Header, und die SDKs von OpenAI und Anthropic warten so lange und versuchen es automatisch erneut. Warten Sie in einer eigenen Schleife die angegebenen Sekunden oder verringern Sie die Parallelität.

Ein 404 mit dem Hinweis, dass das Modell gerade nicht verfügbar ist, bedeutet, dass es beim Upstream-Anbieter kurzzeitig ausgefallen ist. Das liegt nicht an Ihrem Schlüssel oder Ihrem Guthaben. Versuchen Sie es gleich noch einmal oder senden Sie die Anfrage an ein anderes Modell.

Ein vorübergehender Aussetzer beim Upstream-Anbieter oder in der Konfiguration. Ihr Guthaben wird dafür nicht belastet. Wiederholen Sie die Anfrage. Falls sie weiterhin scheitert, melden Sie sich über den Store bei uns, dann gehen wir der Sache nach.

Ja. Streaming-Antworten werden sowohl beim OpenAI- als auch beim Anthropic-Protokoll direkt durchgereicht, und die Nutzung wird aus dem Stream gemessen. Eine gestreamte Anfrage kostet daher genauso viel wie eine nicht gestreamte.

Das ist die ganze Einrichtung.

Einlösen, Schlüssel erstellen, Basis-URL festlegen, Anfrage senden. Dieselben Modelle, bis zu 75 % unter dem Listenpreis.

OpenAI- und Anthropic-kompatibel · Nutzungs-Dashboard inklusive · keine Bindung