Anmerkung des Autors: Diese Anleitung folgt den Schritten in der Konsole. In fünf Schritten binden Sie die GPT-6.1-Terra-API ein. Dabei erfahren Sie, wie Sie den Endpunkt auswählen, welche Parameter Stolperfallen bergen und wie die gestaffelte Preisberechnung ab 272K funktioniert.
Das Wichtigste vorweg: Bei der Anbindung von GPT-6.1 Terra müssen Sie sich vor allem zwischen Responses und Chat Completions entscheiden. Wenn Sie Tools aufrufen möchten, müssen Sie Responses verwenden. Wenn Sie keine Tools benötigen, können Sie Ihren bestehenden Code im Wesentlichen übernehmen und nur den Modellnamen ändern.
GPT-6.1 Terra wurde am 26.10.2026 veröffentlicht. Die Modell-ID lautet gpt-6.1-terra. Die offiziellen Dokumentationen nennen bereits die Endpunkte, Parameter und Preisregeln – diese Angaben sind also belegt. Dieser Artikel folgt der Reihenfolge der Schritte in der Konsole: Registrieren → Token erstellen → Base URL finden → Modellnamen eintragen → erste Anfrage ausführen. Für jeden Schritt gibt es ein Prüfkriterium. Befehlszeilen und Code werden nur als optionale Varianten vorgestellt.
Ihr Nutzen: Nach der Lektüre können Sie die Anbindung der GPT-6.1-Terra-API direkt in der Konsole überprüfen und die häufigsten 400-Fehler vermeiden.
📌 Aktueller Stand der Plattform: Am 27.10.2026 ist
gpt-6.1-terranoch nicht in der aktuellen Modellliste von APIYI (apiyi.com) enthalten. Wir werden das Modell so bald wie möglich bereitstellen. Die Modelle derselben Generation –gpt-6-astra,gpt-6-sol,gpt-6.1-solundgpt-6-luna– sind bereits verfügbar. Sie können zunächstgpt-6.1-solverwenden, um die Anbindung zu überprüfen. Maßgeblich für verfügbare Modelle und Preise ist die Modellliste der Plattform.
GPT-6.1 Terra API: die wichtigsten Punkte
| Punkt | Beschreibung | Bedeutung für dich |
|---|---|---|
| Modell-ID | gpt-6.1-terra, veröffentlicht am 26.10.2026 |
Trage diesen Wert in das Feld model deiner Anfrage ein |
| Verfügbare Endpunkte | Responses, Chat Completions, Batch | Endpunkte wie Realtime, Assistants und Embeddings werden nicht unterstützt |
| Tool-Aufrufe | Werden nur von Responses unterstützt | Anfragen an Chat Completions schlagen fehl, wenn sie tools enthalten |
| Kontext | Insgesamt 1.050.000 Token, bis zu 922.000 Token pro Eingabe und 128.000 Token Ausgabe | Geeignet für lange Dokumente, aber beachte die Preisstufe ab 272K |
| Modalitäten | Text- und Bildeingabe, Textausgabe | Bilder werden über input_image in Responses übergeben |
| Wissensstand | 01.06.2026 | Für aktuellere Informationen musst du das Tool web_search verwenden |
Die Leistungsgrenzen von GPT-6.1 Terra im Detail
GPT-6.1 Terra unterstützt Streaming, strukturierte Ausgaben, Funktionsaufrufe, file_search, Bildeingaben, Websuche und Prompt-Caching. Fine-Tuning und vorhergesagte Ausgaben werden nicht unterstützt. Wenn dein bestehendes Projekt auf feinabgestimmten Modellen oder vorhergesagten Ausgaben beruht, kannst du es daher nicht direkt migrieren.
Über den Responses-Endpunkt lässt sich eine Vielzahl von Tools einbinden, darunter web_search, file_search, image_generation, code_interpreter, hosted_shell, apply_patch, skills, computer_use, mcp und tool_search. Das ist der entscheidende Grund für die Empfehlung „Wenn du Tools brauchst, wähle Responses“: Bei diesem Modell ist Chat Completions ausschließlich für reine Dialoge vorgesehen.
GPT-6.1 Terra API aufrufen: Ablauf in der Konsole in 5 Schritten
Schritt 1: Konto registrieren
- Rufen Sie APIYI unter apiyi.com auf und registrieren Sie sich mit Ihren persönlichen Daten. Die Plattform verlangt, dass Sie das Konto selbst erstellen.
- Ein neues Konto erhält ein Testguthaben von 0,05 US-Dollar. Damit lässt sich auch ohne Aufladung ein einfacher Modellaufruf testen.
- Abnahmekriterium: Melden Sie sich an und öffnen Sie die Konsole. Auf der Wallet- oder Guthabenseite sollte das Testguthaben angezeigt werden.
- Wenn es nicht klappt: Wird kein Guthaben angezeigt, prüfen Sie zuerst, ob Sie die Registrierung vollständig abgeschlossen haben. Sie müssen nicht sofort Guthaben aufladen.
Wenn Sie den offiziellen Zugang nutzen möchten, erstellen Sie einen API-Schlüssel auf der Seite „API Keys“ der OpenAI-Plattform. Voraussetzung dafür ist, dass sich Ihr Konto in einer unterstützten Region befindet und Sie mindestens 5 US-Dollar auf die Build-Stufe aufgeladen haben.
Schritt 2: Token erstellen und die richtige Gruppe auswählen
- Öffnen Sie im Dashboard die Token-Seite unter
api.apiyi.com/tokenund klicken Sie auf „Token erstellen“. - Wählen Sie unter „Gruppe auswählen“ eine Gruppe aus. Die Gruppe legt fest, welche Modelle verfügbar sind, welche Abrechnungsfaktoren gelten und welche Upstream-Verbindung verwendet wird.
defaultundsviphaben dieselben Preise wie der offizielle Dienst,CodexReversenutzt Ressourcen über Reverse Engineering. - Prüfkriterium: Nach dem Speichern wird in der Tokenliste ein Key angezeigt, der mit
sk-beginnt. - Wenn es nicht klappt: Die Gruppe auf Nutzerebene ist nicht dasselbe wie die Token-Gruppe. Entscheidend ist die Gruppe, die Sie direkt beim Token ausgewählt haben.
Schritt 3: Base URL finden
Die Base URL hängt vom verwendeten SDK ab – hier passieren die meisten Eingabefehler:
- OpenAI SDK:
https://api.apiyi.com/v1,/v1muss enthalten sein - Anthropic SDK: Verwenden Sie die Root-Domain ohne
/v1 - Google GenAI SDK: Verwenden Sie die Root-Domain und setzen Sie
api_versionaufv1beta
Prüfkriterium: Für die GPT-6.1-Modellreihe verwenden Sie das OpenAI SDK oder einen OpenAI-kompatiblen Client. Die eingetragene Adresse muss mit /v1 enden. Wenn es nicht klappt: Bei einem 404-Fehler fehlt /v1 in den meisten Fällen oder es wurde doppelt angegeben.
Schritt 4: Modellnamen eintragen
Tragen Sie die Modell-ID in das Modellfeld Ihres Clients oder Debugging-Tools ein. Am besten testen Sie die Verbindung zuerst mit einem leichtgewichtigen Modell wie gpt-5.4-mini und wechseln anschließend zu gpt-6.1-sol. Sobald gpt-6.1-terra auf der Plattform verfügbar ist, müssen Sie nur dieses eine Feld ändern. Die Plattform unterstützt keine kostenlosen Routing-Angaben wie auto oder auto:free. Versuchen Sie es daher nicht damit.
Abnahmekriterien: Der Modellname stimmt Zeichen für Zeichen mit der Schreibweise in der Modellliste der Plattform überein. Wenn etwas nicht klappt: Wird gemeldet, dass das Modell nicht existiert, überprüfen Sie zunächst die Schreibweise in der Modellliste und anschließend, ob die Token-Gruppe Zugriff auf dieses Modell hat.
Schritt 5: Die erste Anfrage erfolgreich senden
Hier ist ein minimales Beispiel mit optionalen Schreibweisen in fünf Zeilen:
- Umgebungsvariable setzen:
export OPENAI_API_KEY=sk-你的令牌 - Client erstellen:
client = OpenAI(base_url="https://api.apiyi.com/v1")– der Schlüssel wird automatisch aus der Umgebungsvariable gelesen - Responses-Variante:
r = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己", reasoning={"effort": "low"}, max_output_tokens=800) - Chat-Variante:
c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "简洁回答"}, {"role": "user", "content": "你好"}], max_completion_tokens=800) - Zur Kontrolle ausgeben:
print(c.model, c.usage.prompt_tokens)
Abnahmekriterien: Die Anfrage liefert HTTP 200 zurück und usage.prompt_tokens enthält einen Zahlenwert (bei Responses prüfen Sie usage.input_tokens). Wechseln Sie zu gpt-6.1-terra: Das Modell sollte dann im Feld model der Antwort erscheinen.
🚀 Schnellstart: Testen Sie
gpt-6.1-solam besten zunächst mit dem Testguthaben bei APIYI apiyi.com. So können Sie überprüfen, ob Schlüssel, Gruppe und Base-URL korrekt eingerichtet sind. Sobald Terra verfügbar ist, können Sie durch Ändern des Modellnamens wechseln. Maßgeblich für Modelle und Preise ist die Modellliste der Plattform.
| Schritt | Aktion in der Konsole | Abnahmekriterien | Bei Problemen zuerst prüfen |
|---|---|---|---|
| 1 Registrierung | Selbst registrieren und anmelden | Ein Testguthaben von 0,05 US-Dollar ist sichtbar | Ist die Registrierung vollständig abgeschlossen? |
| 2 Token | Token erstellen und eine Gruppe auswählen | In der Liste erscheint ein Schlüssel mit dem Präfix sk- |
Werden Token-Gruppe und Benutzergruppe verwechselt? |
| 3 Base-URL | Im OpenAI SDK die Adresse mit /v1 eintragen |
Die Adresse endet auf /v1 |
Bei 404 /v1 überprüfen |
| 4 Modellname | Ein Modell wie gpt-6.1-sol eintragen |
Stimmt Zeichen für Zeichen mit der Modellliste überein | Schreibweise und Modellabdeckung der Gruppe |
| 5 Anfrage | Den ersten Aufruf senden | Antwort mit Status 200 und einem Zahlenwert für usage | Statuscode, Antwortinhalt und x-request-id |
Natürlich können Sie auch direkt Magpie für eine einfachere Anbindung verwenden. Dort tragen Sie Schlüssel und Base-URL in einer grafischen Oberfläche ein. Magpie verbindet dann Programmier-Agents wie Claude Code, Codex, Pi und Hermes automatisch mit demselben Gateway. Sie müssen die Konfigurationsdateien also nicht einzeln bearbeiten.
Auswahl des GPT-6.1-Terra-API-Endpunkts: Responses im Vergleich zu Chat Completions
| Vergleichspunkt | Responses (v1/responses) | Chat Completions (v1/chat/completions) |
|---|---|---|
| Tool-Aufrufe | Unterstützt, bis zu 10 integrierte Tools können eingebunden werden | Nicht unterstützt; Anfragen mit tools schlagen fehl |
| Systemanweisungen | instructions |
Die Rolle developer in messages ist zuverlässiger als system |
| Stärke des Reasonings | reasoning: {effort: ...} |
reasoning_effort |
| Ausgabelimit | max_output_tokens |
max_completion_tokens |
| Eingabeformat | String oder Nachrichtenarray; Bilder werden mit input_image übergeben |
messages-Array |
| Wiederaufnahme über mehrere Runden | include: ["reasoning.encrypted_content"] und die vorherige output unverändert übernehmen |
Nachrichtenverlauf manuell zusammensetzen |
| Usage-Daten beim Streaming | Werden standardmäßig zurückgegeben | Erfordert stream_options: {include_usage: true} |
Vergleich mit Chat Completions: Chat Completions ist besonders vorteilhaft, wenn bestehender Code weiterverwendet werden soll. Die meisten Projekte laufen bereits, wenn nur der Modellname geändert wird. Auf Terra können damit jedoch keine Tools aufgerufen werden, und bei manchen Gruppen werden system-Nachrichten verworfen. Responses unterstützt dagegen nativ Tools und die Wiederaufnahme verschlüsselter Reasoning-Daten und eignet sich daher besser für Agents und mehrstufige Reasoning-Szenarien.
Für die Stärke des Reasonings gibt es sechs Stufen: none, low, medium (Standard), high, xhigh und max. Eine Stufe minimal gibt es nicht. Reasoning-Tokens werden sowohl auf die Ausgabekosten als auch auf das Ausgabelimit angerechnet. Planen Sie daher bei max_output_tokens genügend Spielraum ein – andernfalls kann die Ausgabe abgeschnitten werden, bevor das Reasoning abgeschlossen ist.
Drei typische Parameterfallen bei der GPT-6.1-Terra-API
| Falle | Falsche Schreibweise | Richtige Schreibweise | Folge |
|---|---|---|---|
| Chat mit tools | tools in chat.completions übergeben |
Responses-Endpunkt verwenden | Anfrage schlägt fehl |
| Veralteter Parameter | Im Chat max_tokens übergeben |
Zu max_completion_tokens wechseln |
400 |
| Konflikt bei Sampling-Parametern | temperature oder top_p übergeben, wenn effort nicht none ist |
temperature, top_p und top_logprobs entfernen; im Chat zusätzlich logprobs entfernen |
400 |
Neben diesen drei Fallen nennt die Dokumentation noch einige weitere Fälle, die einen 400-Fehler auslösen: effort ist auf minimal gesetzt, prompt_cache_options.ttl enthält einen ungültigen Wert oder die Eingabe überschreitet 922.000 Tokens. Links zu Bildern müssen vom Server heruntergeladen werden können. Websites mit Anti-Scraping-Maßnahmen können zu Fehlern führen. In diesem Fall ist eine Base64-Data-URL zuverlässiger.
Bei der Fehlersuche ist eine wichtige Gewohnheit entscheidend: Der Originalfehler steht nur einmal im Antworttext. Die Backend-Protokolle dienen als Abrechnungsnachweis; fehlgeschlagene Aufrufe werden dort nicht verbucht. Daher sollten Sie den HTTP-Statuscode, den vollständigen Original-Antworttext und den x-request-id aus den Antwort-Headern sichern. Rufen Sie nicht zuerst raise_for_status() auf und lesen Sie erst danach den Body – sonst gehen die Fehlerinformationen verloren.
GPT-6.1 Terra API-Preise und 272K-Schwelle
Die folgenden offiziellen Preise sind in US-Dollar pro Million Tokens angegeben. Wichtig: Die Preisstufe gilt für die gesamte Anfrage. Sobald die Eingabe mehr als 272K Tokens umfasst, werden alle Kostenpositionen dieser Anfrage nach der zweiten Preisstufe berechnet.
| Kostenposition | Eingabe ≤ 272K | Eingabe > 272K |
|---|---|---|
| Eingabe | 1 | 2 |
| Ausgabe (einschließlich Reasoning-Tokens) | 5 | 7,5 |
| Cache-Lesezugriff | 0,05 | 0,1 |
| Cache-Schreibzugriff (30 Minuten) | 1,25 | 2,5 |
| Cache-Schreibzugriff (12 Stunden) | 2,50 | 5 |
Für eine Kostenschätzung müssen alle vier Positionen berücksichtigt werden: Eingabe, Ausgabe, Cache-Lesezugriff und Cache-Schreibzugriff. Beim Cache-Schreibzugriff ist außerdem zwischen den beiden Laufzeiten von 30 Minuten und 12 Stunden zu unterscheiden. Wer nur die Preise für Eingabe und Ausgabe berücksichtigt, unterschätzt die Kosten bei langen Kontexten mit Cache-Nutzung. Die auf der Plattform verfügbaren Modelle derselben Generation entsprechen bei allen vier Kostenpositionen exakt den offiziellen Preisen und verwenden ebenfalls die Preisstufen für die gesamte Anfrage.
Die offiziellen Ratenlimits im Standard-Tarif sind: Build mit 5.000 RPM / 1 Million TPM, Launch mit 10.000 RPM / 4 Millionen TPM und Grow mit 15.000 RPM / 40 Millionen TPM.
💰 Kostentipp: Begrenzen Sie bei Aufgaben mit langen Dokumenten die Eingabe pro Anfrage möglichst auf 272K Tokens und nutzen Sie zusätzlich Prompt-Caching. So lassen sich die Kosten deutlich senken. Wenn Sie über APIYI apiyi.com die Gruppe
defaultodersvipauswählen, gelten dieselben Preise wie beim offiziellen Anbieter. Die konkreten Modelle und Preise finden Sie in der Modellübersicht der Plattform.
Sicherheitshinweis zur GPT-6.1-Terra-API
Speichern Sie Ihren API-Schlüssel in einer Umgebungsvariablen oder einem Schlüsselverwaltungsdienst. Hinterlegen Sie ihn niemals fest im Quellcode und laden Sie ihn erst recht nicht in ein Git-Repository hoch. Es empfiehlt sich, .env-Dateien in .gitignore auszuschließen. Wenn ein API-Schlüssel offengelegt wurde, löschen Sie ihn umgehend auf der Token-Seite und erstellen Sie einen neuen. Achten Sie außerdem darauf, die richtige Gruppe für den Token auszuwählen: Bei einer falschen Gruppe ist das Modell im besten Fall nicht verfügbar, im ungünstigsten Fall wird mit einem unerwarteten Multiplikator abgerechnet. Verwenden Sie für verschiedene Projekte am besten unterschiedliche Token, damit Sie Kontingente separat verwalten und Token bei Bedarf einzeln deaktivieren können.
Häufige Fragen (FAQ)
Q1: Was ist GPT-6.1 Terra?
GPT-6.1 Terra ist ein am 26.10.2026 von OpenAI veröffentlichtes Modell mit der ID `gpt-6.1-terra`. Das Kontextfenster umfasst 1.050.000 Tokens. Als Eingabe werden Text und Bilder unterstützt, als Ausgabe Text. Das Modell kann über die drei Endpunkte Responses, Chat Completions und Batch aufgerufen werden.
Q2: Wann sollte ich für GPT-6.1 Terra Responses und wann Chat Completions verwenden?
Wenn Sie Tools aufrufen möchten, etwa über function calling oder web_search, verwenden Sie Responses. Für reine Dialoge eignet sich auch Chat. Dabei müssen Sie jedoch `max_completion_tokens` verwenden und dürfen keine `tools` übergeben.
Q3: Kann ich `gpt-6.1-terra` bereits über APIYI aufrufen?
Zum Stand vom 27.10.2026 ist das Modell noch nicht verfügbar. Wir werden es so bald wie möglich anbieten. Bis dahin können Sie bei APIYI auf apiyi.com mit dem Modell derselben Generation, `gpt-6.1-sol`, die Anbindung testen. Maßgeblich sind die Modellliste und Preise auf der Plattform.
Q4: Warum erhalte ich einen 400-Fehler, wenn ich `temperature` übergebe?
Wenn die Reasoning-Stärke nicht auf `none` gesetzt ist, dürfen Sie `temperature`, `top_p` und `top_logprobs` nicht übergeben. Entfernen Sie diese Parameter oder setzen Sie `effort` auf `none`.
Q5: Kann ich das Modell ohne Guthaben testen?
Ja. Neue Konten, die bei APIYI auf apiyi.com registriert werden, erhalten ein Testguthaben von 0,05 US-Dollar. Das reicht aus, um einen einfachen Modellaufruf zu testen. Wir empfehlen, zuerst mit `gpt-5.4-mini` die Anbindung zu überprüfen und anschließend zum gewünschten Modell zu wechseln.
Q6: Welche bekannten Einschränkungen hat GPT-6.1 Terra?
Fine-Tuning und Predicted Outputs werden nicht unterstützt. Auch die Endpunkte Realtime, Assistants, Embeddings, Images und Audio sind nicht verfügbar. Bei Eingaben mit mehr als 272K Tokens wird der gesamte Auftrag zum Tarif der zweiten Stufe abgerechnet. Bei mehr als 922.000 Tokens wird ein 400-Fehler ausgegeben.
GPT-6.1 Terra API: die wichtigsten Punkte
- Die entscheidende Wahl: Wenn Sie Tools benötigen, verwenden Sie Responses. Andernfalls genügt es, bei Chat den Modellnamen zu ändern.
- Drei typische Parameterfallen: Bei Chat keine
toolsmitsenden,max_completion_tokensverwenden und keine Sampling-Parameter übergeben, wenneffortnichtnoneist. - In 5 Schritten in der Konsole: Registrieren, Token erstellen und eine Gruppe auswählen, die Base-URL mit
/v1angeben, den Modellnamen eintragen und eine Anfrage senden. - Woran Sie den Erfolg erkennen: Der Key beginnt mit
sk-, die Anfrage liefert den Status 200 und numerische Werte inusage, und das Feldmodelgibt den Modellnamen zurück. - Vier Preisfaktoren: Eingaben, Ausgaben, Cache-Lesezugriffe und Cache-Schreibzugriffe. Bei mehr als 272K wird der gesamte Auftrag nach der zweiten Preisstufe abgerechnet.
- So gelingt der Einstieg: Testen Sie zunächst mit
gpt-6.1-solüber APIYI die gesamte Verbindung. Sobald Terra verfügbar ist, müssen Sie nur den Modellnamen ändern.
Zusammenfassung
Die wichtigsten Punkte zur Anbindung der GPT-6.1-Terra-API lassen sich in drei Punkten zusammenfassen:
- Zuerst den Endpunkt wählen: Entscheiden Sie zunächst, ob Sie Responses oder Chat verwenden. Davon hängen die Parameter und die Möglichkeit ab, Tools aufzurufen.
- Schritt für Schritt prüfen: Für Token, Base-URL, Modellname und die erste Anfrage gibt es jeweils eindeutige Prüfsignale.
- Kosten im Blick behalten: Die 272K-Preisstaffel gilt für den gesamten Auftrag. Berücksichtigen Sie alle vier Cache-Gebühren in Ihrem Budget.
Wir empfehlen, zunächst mit gpt-6.1-sol über APIYI (apiyi.com) die gesamte Verbindung zu testen. Am 27.10.2026 war gpt-6.1-terra auf der Plattform noch nicht verfügbar. Wir werden das Modell so bald wie möglich bereitstellen. Maßgeblich sind die Modellliste und die Preise auf der Plattform.
📚 Referenzen
- OpenAI-Modellseite – GPT-6.1 Terra: Modellspezifikationen und unterstützte Endpunkte
- Link:
platform.openai.com/docs/models/gpt-6.1-terra -
Beschreibung: Offizielle Angaben zu Kontext, Modalitäten und verfügbaren Tools
-
Aktueller Modellleitfaden von OpenAI: Parameterumstellung und Einschränkungen
- Link:
platform.openai.com/docs/guides/latest-model -
Beschreibung: Regeln für Parameter wie reasoning.effort und max_completion_tokens
-
OpenAI-Preisseite: Gestaffelte Preise und Preise für den Cache
- Link:
platform.openai.com/docs/pricing - Beschreibung: Die zwei Preisstufen für 272K sowie Preise nach Cache-Schreibdauer
Autor: Technisches Team von APIYI
Technischer Austausch: Kontaktieren Sie uns gern über die Startseite der APIYI-Website. Weitere Informationen zur Anbindung finden Sie im Dokumentationszentrum unter docs.apiyi.com.
