Von xAI zu FlowModels.
Die xAI-API folgt dem OpenAI-Format. Du tauschst Basis-URL und Schlüssel und stellst dem Modell xai/ voran.
Was sich ändert
Basis-URL, Schlüssel und Modellname. Alles Übrige bleibt, solange du keine Felder aus der Tabelle weiter unten benutzt.
| Stelle | Vorher | Bei FlowModels |
|---|---|---|
| Basis-URL | https://api.x.ai/v1 |
https://api.flowmodels.one/v1 |
| Schlüssel | XAI_API_KEY |
FLOWMODELS_API_KEY |
| Modellname | grok-4.7 |
xai/grok-4.7 |
Der Code davor und danach
client = OpenAI(
- base_url="https://api.x.ai/v1",
- api_key=os.environ["XAI_API_KEY"],
+ base_url="https://api.flowmodels.one/v1",
+ api_key=os.environ["FLOWMODELS_API_KEY"],
)
response = client.chat.completions.create(
- model="grok-4.7",
+ model="xai/grok-4.7",
messages=[{"role": "user", "content": "Hallo!"}],
)
Felder, die sich anders verhalten
Maßgeblich ist, was das gewählte Modell kann. Welche Felder es annimmt, steht bei GET /v1/models unter supported_parameters.
| Feld | Verhalten bei FlowModels |
|---|---|
web_search |
Die Websuche schaltest du bei Modellen, die das können, mit web_search: true ein. search_domain_filter nimmt bei xAI bis zu fünf Domains. |
reasoning_effort |
Nur bei Modellen mit Reasoning. Die Stufen stehen unter capabilities.reasoning_levels; eine andere Stufe ergibt 400 unsupported_for_model. |
response_format |
json_object und json_schema, je nachdem, was das Modell kann. Sonst kommt 400 unsupported_for_model. |
tools, tool_choice |
Nur Typ function. FlowModels führt deine Funktionen nicht aus, das Modell meldet tool_calls. |
Das prüfst du nach dem Umstieg
-
Der neue Schlüssel steht in
FLOWMODELS_API_KEY, undGET /v1/modelsnennt dein Modell. -
Ein Aufruf ohne Streaming liefert wie erwartet
choices[0].message.content. -
Mit
stream: truekommen die Ereignisse an; mitstream_options.include_usagesteht der Verbrauch im letzten Ereignis. -
Werkzeugaufrufe und
response_formatlaufen mit genau dem Modell, das du einsetzt. -
Deine Fehlerbehandlung trennt
429 insufficient_quota(Guthaben leer) von429 rate_limit_exceeded,429 concurrent_requests_exceededund503 provider_overloaded. - Im Anfrageprotokoll deines Dashboards stehen Modell, Token und Kosten des Aufrufs.
- Rechne bei Websuche mit Zusatzkosten: Jede Suche wird zusätzlich abgerechnet.