API | Grok 4.5 API – Coding-Modell von xAI, 500K

xai/grok-4.5/chat

Grok 4.5 ist xAIs Coding-Modell für agentische Software- und Engineering-Aufgaben, hinter einem OpenAI-kompatiblen Chat-Aufruf. Es nimmt bis zu 500.000 Token auf, antwortet mit bis zu 450.000, und der Reasoning-Aufwand reicht bis xhigh.

Eingabe $2Ausgabe $6je 1 Mio. TokenEingabe aus dem Cache $0.30Prompts ab 200K TokenEingabe $4Ausgabe $12

Modell ausführen API ansehen

Anfrage senden

Die Beispiele verwenden die öffentlichen Parameter des gewählten Endpunkts. Ersetzen Sie API-Schlüssel und Beispielmedien und senden Sie die Anfrage von Ihrem Server.

SDKs & Integrationen

POSThttps://api.spicyapi.ai/v1/chat/completions

API-Authentifizierung

Bewahren Sie den API-Schlüssel serverseitig in der Umgebungsvariablen SPICY_API_KEY auf. Verwenden Sie Bearer-Authentifizierung und für JSON-Anfragen Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-4.5/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Erzeugt aus dem Eingabeschema dieses Modells – genau dem, gegen das die API jede Anfrage prüft.

Behalten Sie für jede logische Anfrage denselben Idempotency-Key. Senden Sie nach einem Verbindungsabbruch nicht automatisch mit einem neuen Key erneut, sondern bewahren Sie die request_id auf, um die angenommene Anfrage zu prüfen. Ein früherer Chat-Stream wird dabei nicht noch einmal ausgeliefert.

Eingabeparameter

Die Modellparameter stehen direkt im JSON-Request-Body auf derselben Ebene wie model. Dieser Endpunkt verwendet kein input-Objekt.

messagesarray<object>Erforderlich

Höchstens 256 Züge. Der Inhalt darf Text- und image_url-Teile in einer Nutzernachricht mischen; Datei- oder PDF-Teile gibt es an diesem Endpunkt nicht.

Standardwert: Nicht festgelegt
Einschränkungen: minItems:1
maxItems:256

messages[].rolestringIm Objekt erforderlich

Role of the message author.

Standardwert: Nicht festgelegt
Zulässige Werte: "system""developer""user""assistant""tool"

messages[].namestringOptional

Optional name identifying the speaker within its role.

Standardwert: Nicht festgelegt

messages[].contentstring | array | nullOptional

Message content, either plain text or a list of content parts.

Standardwert: Nicht festgelegt

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "detail": {
                "enum": [
                  "auto",
                  "low",
                  "high"
                ],
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Optional

Tool calls the assistant requested in this message.

Standardwert: Nicht festgelegt

messages[].tool_call_idstringOptional

Identifier of the tool call this message answers. Required on tool messages.

Standardwert: Nicht festgelegt

messages[].reasoning_contentstringOptional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Standardwert: Nicht festgelegt

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "detail": {
                      "enum": [
                        "auto",
                        "low",
                        "high"
                      ],
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectOptional

Verlangen Sie ein JSON-Objekt, wenn die Antwort vom nächsten Schritt eines Agenten geparst und nicht von einem Menschen gelesen wird.

Standardwert: Nicht festgelegt

tool_choicestring | objectOptional

auto, none, required – oder ein Objekt, das die aufzurufende Funktion benennt.

Standardwert: Nicht festgelegt

parallel_tool_callsbooleanOptional

true oder false, Standard true: Das Modell darf in einem Zug mehrere Tool-Aufrufe anfordern. Mit false kommt höchstens ein Aufruf pro Zug – für Schleifen, in denen jeder Aufruf vom vorherigen Ergebnis abhängt. Kein Einfluss auf den Preis.

Standardwert: true

toolsarray<object>Optional

Bis zu 128 Funktionsdefinitionen pro Anfrage. Bleibt ihre Reihenfolge zwischen den Schritten gleich, bleibt der Anfang eher cachefähig.

Standardwert: Nicht festgelegt
Einschränkungen: maxItems:128

top_pnumberOptional

0,01 bis 1. Ändern Sie entweder diesen Wert oder temperature, nicht beide.

Standardwert: 1
Einschränkungen: minimum:0.01
maximum:1

temperaturenumberOptional

0 bis 2, Vorgabe 0,7. Nehmen Sie 0, wenn Sie zwei Patches oder zwei Läufe derselben Aufgabe vergleichen.

Standardwert: 0.7
Einschränkungen: minimum:0
maximum:2

max_tokensintegerOptional

Begrenzt die sichtbare Antwort auf 450.000 Token; die Vorgabe von 4.096 schneidet lange Antworten stillschweigend ab. Reasoning-Token werden als Ausgabe berechnet, unterliegen dieser Grenze aber NICHT – an diesem Endpunkt gemessen: Denkaufwand high bei einer Grenze von 800 ergab 18.339 Ausgabe-Token. Senken Sie reasoning_effort, wenn Sie eine planbare Obergrenze brauchen.

Standardwert: 4096
Einschränkungen: minimum:1
maximum:450000

reasoning_effortstringOptional

low, medium, high oder xhigh. high ist die Vorgabe; der Denkaufwand wird in Ausgabe-Token bezahlt, xhigh erhöht die Rechnung also auch bei kurzer Antwort.

Standardwert: "high"
Zulässige Werte: "low""medium""high""xhigh"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "detail": {
                          "enum": [
                            "auto",
                            "low",
                            "high"
                          ],
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 450000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 0.7,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "high",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 2048,
  "x-input-token-limit": 500000,
  "additionalProperties": false
}

Ergebnis auslesen

Mit stream: false liefert die Anfrage die vollständige Chat-Antwort direkt zurück. Lesen Sie choices[].message; ein Auftrag muss dafür nicht abgefragt werden. Für Clients mit Unterstützung für Server-Sent Events können Sie stream auf true setzen.

Beispiel einer fertigen Antwort

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "xai/grok-4.5/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Die Antwort dient als Strukturbeispiel. usage enthält Tokenzahlen; tatsächlicher Verbrauch und Kosten hängen von der Anfrage ab.

SDKs & Integrationen

Nutzen Sie SpicyAPI in Ihrer App, im Terminal, mit KI-Assistenten oder in visuellen Workflows. Wählen Sie die passende Anleitung.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Terminalbefehle und Automatisierungsskripte.

MCP

Claude Code · Cursor · Codex

Agent Skill

Wiederverwendbare Anweisungen für Ihren KI-Assistenten.

n8n

Community-Nodes für selbst gehostetes n8n und importierbare HTTP Request-Vorlagen für n8n Cloud.

ComfyUI

Bild-, Video- und Audio-Workflows auf einer Node-Oberfläche.

Weitere Integrationen

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Fertige Workflows entdecken

Ein Chat-Modell: Es läuft überall dort, wo die Chat-API von OpenAI läuft. Client behalten, Base-URL austauschen, dieses Modell über seine ID auswählen.

Jeden OpenAI-kompatiblen Client hierher zeigen lassen

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/xai/grok-4.5/chat

Alles, was die OpenAI-Chat-API nutzt, funktioniert auf dieselbe Weise – SDKs, das Vercel AI SDK, LangChain, aider und Cline. Der MCP-Server und die spicyapi-CLI decken asynchrone Medienaufgaben ab. Die Einrichtung der einzelnen Tools finden Sie im Entwicklerbereich.

In SillyTavern und Rollenspiel-Apps nutzen

In SillyTavern, RisuAI, Agnai oder jeder App mit OpenAI-kompatibler Einstellung fügen Sie die Basis-URL unten und Ihren API-Schlüssel ein und wählen xai/grok-4.5/chat als Modell. Aufrufe direkt aus dem Browser sind erlaubt, und Regler, die dieses Modell nicht kennt, werden ignoriert statt abgelehnt.

Base URL: https://api.spicyapi.ai/v1
Model: xai/grok-4.5/chat

SillyTavern-Anleitung RisuAI, Agnai und mehr SillyTavern-Erweiterung

In ComfyUI nutzen

Installieren Sie die SpicyAPI-Nodes über den ComfyUI Manager oder mit dem Befehl unten und wählen Sie im SpicyAPI Chat-Node xai/grok-4.5/chat, um dieses Modell in einem ComfyUI-Graphen zu nutzen.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Workflow-Beispiele Einrichtungsanleitung Quellcode auf GitHub

Das eingebettete Panel liest dasselbe Schema wie diese Seite und kann daher nicht von der API abweichen. Soll der Inhalt in Ihrer Dokumentation durchsuchbar bleiben, holen Sie stattdessen das JSON unter /api/embed/models/ und rendern es selbst.

<iframe src="https://spicyapi.ai/embed/de/models/grok-4-5/api?model=xai%2Fgrok-4.5%2Fchat" width="100%" height="560" loading="lazy" title="Anfragebeispiel" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Panel öffnen

Playground

Anfrage senden

API-Authentifizierung

Eingabeparameter

Ergebnis auslesen

SDKs & Integrationen

In SillyTavern und Rollenspiel-Apps nutzen

In ComfyUI nutzen