Grok 4.7: czat do roleplayu bez cenzury i cennik

xai/grok-4.7/chat

Grok 4.7 to model czatu xAI za wywołaniem zgodnym z OpenAI, ze streamingiem SSE. Ma kontekst 500 000 tokenów i odpowiada do 450 000, z wysiłkiem rozumowania od low do xhigh; na tej platformie nie dodajemy żadnego filtra.

Wejście $2Wyjście $6za 1 mln tokenówWejście z pamięci podręcznej $0.50Prompty od 200K tokenów wzwyżWejście $4Wyjście $12

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

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

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i 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.7/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'

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Dla każdego logicznego żądania zachowaj jeden Idempotency-Key. Po przerwaniu połączenia nie wysyłaj automatycznie ponownie z nowym kluczem; zachowaj request_id, żeby sprawdzić przyjęte żądanie. Idempotentność nie odtwarza wcześniejszego strumienia czatu.

Parametry wejściowe

Parametry modelu umieść bezpośrednio w ciele żądania JSON, obok model. Ten endpoint nie używa opakowania input.

messagesarray<object>Wymagane

Najwyżej 256 tur. Treść może mieszać części text i image_url w jednej wiadomości użytkownika. Rola systemowa jest na tym endpoincie respektowana (sprawdziliśmy to celowo), więc rama ustawiona raz na początku działa przez cały wątek.

Domyślnie: Nie określono
Ograniczenia: minItems:1
maxItems:256

messages[].rolestringWymagane wewnątrz obiektu

Role of the message author.

Domyślnie: Nie określono
Dozwolone wartości: "system""developer""user""assistant""tool"

messages[].namestringOpcjonalne

Optional name identifying the speaker within its role.

Domyślnie: Nie określono

messages[].contentstring | array | nullOpcjonalne

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

Domyślnie: Nie określono

{
  "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>Opcjonalne

Tool calls the assistant requested in this message.

Domyślnie: Nie określono

messages[].tool_call_idstringOpcjonalne

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

Domyślnie: Nie określono

messages[].reasoning_contentstringOpcjonalne

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

Domyślnie: Nie określono

{
  "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_formatobjectOpcjonalne

Poproś o obiekt JSON, gdy odpowiedź będzie przetwarzana przez kod, a nie czytana przez człowieka.

Domyślnie: Nie określono

tool_choicestring | objectOpcjonalne

auto, none, required albo obiekt wskazujący funkcję do wywołania.

Domyślnie: Nie określono

parallel_tool_callsbooleanOpcjonalne

true lub false, domyślnie true: model może w jednej turze zażądać kilku wywołań narzędzi. Ustaw false, aby dostać najwyżej jedno wywołanie na turę – przydaje się to w pętlach, w których każde wywołanie zależy od poprzedniego wyniku. Nie wpływa na cenę.

Domyślnie: true

toolsarray<object>Opcjonalne

Do 128 definicji funkcji na żądanie. Ta generacja stosunkowo słabo radzi sobie w długich pętlach agentowych.

Domyślnie: Nie określono
Ograniczenia: maxItems:128

top_pnumberOpcjonalne

Od 0,01 do 1. Ruszaj ten parametr albo temperature, a nie oba naraz.

Domyślnie: 1
Ograniczenia: minimum:0.01
maximum:1

temperaturenumberOpcjonalne

Od 0 do 2, domyślnie 0,7. W okolicach 0,9 proza zyskuje rozpiętość; 0 ustawiaj tylko wtedy, gdy porównujesz dwa przebiegi i różnica między nimi ma wynikać z jednej zmiany.

Domyślnie: 0.7
Ograniczenia: minimum:0
maximum:2

max_tokensintegerOpcjonalne

Ogranicza widoczną odpowiedź do 450 000 tokenów; domyślne 4 096 po cichu ucina długą odpowiedź. Tokeny rozumowania są rozliczane jako wyjście, ale NIE podlegają temu limitowi. Obniż reasoning_effort, gdy potrzebujesz przewidywalnego pułapu.

Domyślnie: 4096
Ograniczenia: minimum:1
maximum:450000

reasoning_effortstringOpcjonalne

low, medium, high albo xhigh; domyślnie high. Do dialogu i roleplayu używaj low lub medium: przy high model zużywa tokeny wyjścia na namysł, a tekst brzmi jak wahanie. Wysiłek rozumowania rozlicza się jako wyjście, więc to ostrożniejsze ustawienie jest zarazem droższe.

Domyślnie: "high"
Dozwolone wartości: "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
}

Odczytaj wynik

Przy stream ustawionym na false żądanie zwraca gotową odpowiedź czatu od razu. Czytaj choices[].message; odpytywanie zadania nie jest potrzebne. Ustaw stream na true, jeśli twój klient obsługuje Server-Sent Events.

Przykład odpowiedzi po zakończeniu

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "xai/grok-4.7/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
  }
}

Przykładowa odpowiedź jest poglądowa. usage podaje liczbę tokenów; liczba tokenów i opłata zależą od twojego rzeczywistego żądania.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

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

Przeglądaj gotowe przepływy pracy

To model czatowy, więc działa wszędzie tam, gdzie działa czatowe API OpenAI: zostaw swojego klienta, zmień adres bazowy i wskaż ten model po jego identyfikatorze.

Podłącz dowolnego klienta zgodnego z OpenAI

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

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

Narzędzia obsługujące API czatu OpenAI działają w ten sam sposób: SDK, Vercel AI SDK, LangChain, aider i Cline. Serwer MCP i CLI spicyapi obsługują asynchroniczne zadania multimedialne. Konfiguracje poszczególnych narzędzi znajdziesz w centrum dla deweloperów.

Używaj w SillyTavern i aplikacjach do roleplayu

W SillyTavern, RisuAI, Agnai lub dowolnej aplikacji z ustawieniem zgodnym z OpenAI wklej poniższy bazowy URL i swój klucz API, a jako model wybierz xai/grok-4.7/chat. Wywołania prosto z przeglądarki są dozwolone, a suwaki, których ten model nie obsługuje, są pomijane zamiast odrzucane.

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

Przewodnik po SillyTavern RisuAI, Agnai i inne Rozszerzenie SillyTavern

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wybierz xai/grok-4.7/chat w węźle SpicyAPI Chat, aby używać tego modelu w schemacie ComfyUI.

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

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/grok-4-7/api?model=xai%2Fgrok-4.7%2Fchat" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Odczytaj wynik

SDK i integracje

Używaj w SillyTavern i aplikacjach do roleplayu

Użyj w ComfyUI