Ostatnia weryfikacja: 28 września 2026 r.
xAI wprowadziło Grok 4.7 we wrześniu 2026 r. do programowania, zadań agentowych i pracy z wiedzą. Obsługuje okno kontekstu 500,000 tokenów, Responses API oraz Chat Completions. Dla deweloperów trudność często nie polega na pierwszym żądaniu, lecz na zarządzaniu kolejnym dostawcą: poświadczeniami, konfiguracją SDK, kontem rozliczeniowym, katalogiem modeli i endpointem, obok reszty wielomodelowego stosu.
Możesz wywołać Grok 4.7 z Pythona za pomocą OpenAI SDK, kierując klienta na CometAPI, uwierzytelniając się kluczem CometAPI i wybierając grok-4.7. To samo konto CometAPI, klucz i bazowy URL mogą zapewnić dostęp do obsługiwanych modeli GPT, Claude, Gemini i DeepSeek. Innymi słowy, możesz utrzymać jedno zintegrowane wejście do bramki, jednocześnie wybierając model dopasowany do konkretnego zadania.
Ten przewodnik używa Grok 4.7 do pierwszego działającego żądania, a następnie pokazuje, co pozostaje niezmienne po dodaniu innych rodzin modeli. Wyjaśnia też ważne ograniczenie „jednego API”: uwierzytelnianie i dostęp przez bramkę są zunifikowane, ale narzędzia specyficzne dla modeli, parametry, limity kontekstu i obsługiwane endpointy nadal mogą się różnić.
Szybki start Grok 4.7 w Pythonie
Aktualna strona modelu CometAPI Grok 4.7 dokumentuje identyfikator modelu grok-4.7, bazowy URL https://api.cometapi.com/v1 oraz przykład w Pythonie zbudowany na OpenAI SDK. Dedykowana strona używa Responses API, więc to najbezpieczniejszy punkt wyjścia dla tego tutorialu.
1. Utwórz klucz CometAPI
Utwórz konto CometAPI lub zaloguj się, a następnie wygeneruj klucz w konsoli tokenów API. Przechowuj go w zmiennej środowiskowej zamiast umieszczać sekret bezpośrednio w kodzie źródłowym.
export COMETAPI_KEY="your_cometapi_key_here"
Dla Windows PowerShell:
$env:COMETAPI_KEY="your_cometapi_key_here"
Nie commituj klucza do Git, nie wklejaj go do publicznego notatnika ani nie eksponuj w JavaScript po stronie przeglądarki. Aplikacje produkcyjne powinny ładować go z menedżera sekretów lub chronionego środowiska serwerowego.
2. Zainstaluj OpenAI Python SDK
Utwórz izolowane środowisko i zainstaluj aktualne SDK:
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade openai
W systemie Windows aktywuj środowisko za pomocą .venv\Scripts\Activate.ps1. Oficjalny OpenAI API quickstart używa tego samego pakietu Python i wzorca klienta; CometAPI zmienia klucz API, bazowy URL i identyfikator modelu.
3. Wyślij pierwsze żądanie do Grok 4.7
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
response = client.responses.create(
model="grok-4.7",
input="Explain one practical use of a unified AI API in two sentences.",
)
print(response.output_text)
Zapisz plik jako grok47_quickstart.py, a następnie uruchom:
python grok47_quickstart.py
Jeśli żądanie powiedzie się, skrypt wypisze tekstową odpowiedź modelu. Twoja aplikacja używa teraz klienta OpenAI dla Pythona, wysyłając ruch do CometAPI i wybierając Grok 4.7 poprzez identyfikator modelu.
Co robi każda linia w żądaniu do Grok 4.7
api_key. SDK wysyła Twoje poświadczenie CometAPI w żądaniu. Jeden klucz CometAPI może być używany w modelach włączonych dla tego samego konta.
base_url. Przekierowuje klienta OpenAI z domyślnej usługi OpenAI do bramki CometAPI. Zachowaj sufiks /v1.
model="grok-4.7". Identyfikator modelu wybiera Grok 4.7. Traktuj identyfikatory modeli jako dokładne, rozróżniające wielkość liter wejścia wdrożeniowe i potwierdzaj je na żywej stronie modelu przed wydaniem.
client.responses.create(...). Wysyła żądanie przez Responses API. Aktualna strona Grok 4.7 w CometAPI dokumentuje tę trasę, a obecna dokumentacja xAI dla Grok 4.7 również wymienia Responses API jako obsługiwane.
Czy można używać Grok 4.7 z Chat Completions zamiast tego?
Tak. Dziennik zmian CometAPI z 22 września 2026 r. stwierdza, że Grok 4.7 obsługuje format Chat API. Jeśli istniejąca aplikacja jest zbudowana wokół Chat Completions, odpowiadające wywołanie OpenAI SDK to:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
completion = client.chat.completions.create(
model="grok-4.7",
messages=[
{
"role": "user",
"content": "Give me a three-step API migration checklist.",
}
],
)
print(completion.choices[0].message.content)
Używaj Responses, gdy odpowiada to stronie modelu i nowszemu workflow OpenAI SDK. Używaj Chat Completions, gdy utrzymujesz istniejącą integrację czatową. Nie zakładaj, że każde natywne narzędzie lub parametr specyficzny dla modelu ma identyczną reprezentację w obu formatach.
Jak jedna integracja CometAPI sięga GPT, Claude, Gemini, DeepSeek i Grok
Zunifikowana bramka modeli jest przydatna, gdy aplikacja potrzebuje kilku rodzin modeli bez utrzymywania oddzielnych poświadczeń i ścieżek inicjalizacji klienta dla każdego dostawcy. W CometAPI klucz API i bazowy URL pozostają stałe, a aplikacja wybiera identyfikator modelu z aktualnego katalogu. Format endpointu i funkcje specyficzne dla dostawcy mogą się różnić, więc każdy model należy przetestować z dokładnym kształtem żądania używanym w produkcji.
Aktualne opcje modeli w CometAPI (zweryfikowano 28 września 2026 r.)
| Rodzina modeli | Aktualny identyfikator przykładowego modelu | Opis modelu i co zweryfikować |
|---|---|---|
| Grok | grok-4.7 | Grok 4.7 jest ukierunkowany na programowanie, zadania agentowe i długą pracę z wiedzą. Zweryfikuj format Responses vs Chat, sterowanie rozumowaniem, narzędzia oraz bieżące stawki. |
| GPT | gpt-6-sol | GPT-6 Sol jest zoptymalizowany do złożonego programowania i przepływów agentowych. Zweryfikuj obsługę endpointów, poziom rozumowania, potrzeby kontekstu i dostępność narzędzi. |
| Claude | claude-opus-5-5 | Claude Opus 5.5 to wysoko wydajny model rozumujący i agentowy. Zweryfikuj format Messages vs Chat oraz zachowanie narzędzi specyficzne dla Anthropic. |
| Gemini | gemini-3.8-flash | Gemini 3.8 Flash priorytetyzuje szybkość i obciążenia multimodalne. Zweryfikuj format natywny Gemini vs Chat, wejścia multimedialne i opcje uziemiania. |
| DeepSeek | deepseek-v4-pro | DeepSeek V4 Pro koncentruje się na zaawansowanym rozumowaniu, programowaniu i agentach długiego horyzontu. Zweryfikuj zgodność z Chat, zachowanie rozumowania i bieżące limity wyjścia. |
Te identyfikatory modeli zostały sprawdzone w katalogu i na stronach modeli CometAPI 28 września 2026 r. Dostępność, aliasy i ceny mogą się zmieniać; kod produkcyjny powinien używać zatwierdzonej listy dozwolonych wartości i ponownie sprawdzać żywy katalog przed wdrożeniem.
Dla prostego workflow tekstowego zgodnego z OpenAI możesz uczynić model konfigurowalnym:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
model = os.getenv("COMETAPI_MODEL", "grok-4.7")
response = client.responses.create(
model=model,
input="Summarize the advantages and limits of a unified AI API.",
)
print(response.output_text)
Elementy wielokrotnego użytku to konto, klucz API, URL bramki, inicjalizacja SDK i otoczka żądań Twojej aplikacji. To, co może się zmieniać, to endpoint lub schemat żądania wymagany przez konkretną rodzinę modeli. Zunifikowane API redukuje fragmentację integracji i rozliczeń; nie znosi możliwości i ograniczeń modeli źródłowych.
Bezpieczniejszy wielomodelowy wzorzec w Pythonie
Aplikacje produkcyjne powinny definiować listę dozwolonych modeli zamiast akceptować dowolne nazwy modeli od użytkowników. Przechowuj informacje o możliwościach obok każdego zatwierdzonego modelu, aby aplikacja wybierała kompatybilny endpoint i zestaw funkcji.
MODEL_CONFIG = {
"grok": {
"id": "grok-4.7",
"api": "responses",
},
"gpt": {
"id": "gpt-6-sol",
"api": "responses",
},
}
def run_text_request(client, family, prompt):
config = MODEL_CONFIG[family]
if config["api"] == "responses":
result = client.responses.create(
model=config["id"],
input=prompt,
)
return result.output_text
raise ValueError(f"Unsupported API format: {config['api']}")
Rozszerzaj listę dozwolonych modeli dopiero po przetestowaniu wybranego modelu z endpointem i parametrami używanymi przez Twoją aplikację. Takie podejście zapobiega cichej zmianie routingu ruchu produkcyjnego do niezamierzonego modelu przez zmianę w katalogu lub literówkę.
Typowe błędy i jak je naprawić
Błąd uwierzytelniania. Potwierdź, że COMETAPI_KEY jest obecny w tej samej powłoce, w której uruchamiasz Pythona, że klucz jest aktywny i że do wartości nie skopiowano zbędnych spacji lub cudzysłowów.
Nie znaleziono modelu. Sprawdź dokładny, żywy identyfikator modelu. Dla tego przewodnika zweryfikowany identyfikator to grok-4.7; nie używaj nazwy wyświetlanej, takiej jak „Grok 4.7 API”.
Endpoint odrzuca parametr. Usuń opcje specyficzne dla dostawcy i ponów próbę z minimalnym, udokumentowanym żądaniem. Zgodność z OpenAI obejmuje wspólne kształty SDK, a nie każdy natywny parametr w GPT, Claude, Gemini, DeepSeek i Grok.
Żądanie jest ograniczane lub saldo jest niewystarczające. Sprawdź użycie konta i limit przed zwiększaniem retry. Ślepe ponowienia mogą zwielokrotniać koszty i obciążenie bez rozwiązania limitu na poziomie konta.
Żądanie przekracza limit czasu lub zwraca tymczasowy błąd serwera. Dodaj ograniczony wykładniczy backoff, limit czasu żądania i maksymalną liczbę ponowień. Loguj identyfikator żądania i wybrany model, ale nigdy nie loguj klucza API ani wrażliwej treści promptu.
Lista kontrolna dla produkcji
- Przechowuj klucz CometAPI w menedżerze sekretów i rotuj go, jeśli zostanie ujawniony.
- Przypnij zatwierdzone identyfikatory modeli w konfiguracji i przeglądaj żywy katalog przed wdrożeniem.
- Przetestuj dokładny endpoint, tryb strumieniowania, wywołania narzędzi, strukturyzowane wyjście i wejścia multimodalne, których planujesz używać.
- Ustaw jawne limity czasu i ograniczone ponowienia; nie ponawiaj nieprawidłowych żądań.
- Rejestruj model, opóźnienie, użycie tokenów, identyfikator żądania i metadane kosztów, nie przechowując sekretów.
- Uruchom małego kanarka przed przeniesieniem ruchu produkcyjnego na nowy model lub alias.
Dlaczego używać CometAPI w tym workflow?
CometAPI jest przydatne, gdy zespół chce testować lub obsługiwać kilka rodzin modeli bez tworzenia oddzielnej integracji, ścieżki poświadczeń i przedpłaconego salda dla każdego dostawcy. Szybki start z Grok 4.7 używa znajomego klienta OpenAI dla Pythona, a to samo konto CometAPI może obejmować obsługiwane modele GPT, Claude, Gemini, DeepSeek, Grok i multimodalne.
Zaletą jest konsolidacja operacyjna: jedno konto, jeden klucz, jeden URL bramki i wspólna powierzchnia użycia. Dyscyplina inżynieryjna pozostaje jednak świadoma modelu. Zespoły powinny nadal weryfikować zgodność endpointów, możliwości specyficzne dla modeli, ceny, wymagania dotyczące danych oraz zachowanie awaryjne przed produkcją.
Cennik Grok 4.7 przez CometAPI
Strona modelu Grok 4.7 w CometAPI wymienia dwa poziomy kontekstu. Poniższe ceny są w dolarach amerykańskich za 1 milion tokenów i zostały zweryfikowane 28 września 2026 r.
| Poziom | Warunek | Wejście | Wejście z cache / odczyt cache | Wyjście |
|---|---|---|---|---|
| Standardowy kontekst | len < 200,000 | $1.60 | $0.40 | $4.80 |
| Poziom długiego kontekstu | Zobacz bieżącą zasadę rozliczeń na żywej stronie modelu | $3.20 | $0.80 | $9.60 |
Ta sama strona wymienia odpowiadające stawki bezpośrednie xAI jako $2.00 za wejście, $0.50 za odczyt z cache i $6.00 za wyjście dla standardowego kontekstu oraz $4.00 za wejście, $1.00 za odczyt z cache i $12.00 za wyjście dla długiego kontekstu. To sprawia, że wyświetlane stawki CometAPI są o 20% niższe w momencie weryfikacji. Traktuj te wartości jako datowaną migawkę i sprawdź żywą stronę cen przed szacowaniem wydatków produkcyjnych.
FAQ
Jaki jest identyfikator modelu Grok 4.7 w CometAPI?
Aktualny identyfikator modelu to grok-4.7.
Czy mogę używać OpenAI Python SDK z Grok 4.7?
Tak. Zainicjalizuj OpenAI swoim kluczem CometAPI, ustaw bazowy URL API na api.cometapi.com/v1, a następnie wywołaj obsługiwany endpoint z model="grok-4.7".
Czy potrzebuję także klucza API xAI?
Nie dla ścieżki przez CometAPI pokazanej tutaj. Żądanie uwierzytelnia się kluczem CometAPI i jest rozliczane przez konto CometAPI.
Czy ten sam klucz CometAPI może uzyskać dostęp do GPT, Claude, Gemini i DeepSeek?
Tak, dla modeli dostępnych na Twoim koncie CometAPI. Zachowaj klucz CometAPI i bazowy URL, wybierz obsługiwany identyfikator modelu i użyj endpointu udokumentowanego dla tego modelu.
Czy „jedno API” oznacza, że każdy model akceptuje identyczne parametry?
Nie. Jedno API może ujednolicić dostęp do konta, uwierzytelnianie, routing i rozliczenia. Natywne narzędzia, sterowanie rozumowaniem, wejścia multimodalne, ustawienia bezpieczeństwa, limity kontekstu i obsługa endpointów nadal mogą się różnić w zależności od modelu.
Czy dla Grok 4.7 powinienem używać Responses czy Chat Completions?
Zacznij od Responses, ponieważ aktualna strona modelu Grok 4.7 w CometAPI podaje ten przykład. Chat Completions jest również udokumentowane w dzienniku zmian CometAPI i może być właściwe dla istniejącej bazy kodu opartej na czacie.
Najważniejsze wnioski
Aby wywołać Grok 4.7 z Pythona, zainstaluj OpenAI SDK, utwórz klucz CometAPI, ustaw bazowy URL CometAPI pokazany w sekcji konfiguracji i wybierz grok-4.7. Zacznij od minimalnego żądania, potwierdź endpoint i kształt odpowiedzi, a następnie dodaj ponowienia, limity czasu, logowanie i kontrolę kosztów przed wejściem w produkcję.
Używaj wspólnej integracji jako stabilnej podstawy, a następnie utrzymuj jawne sprawdzanie możliwości dla każdego dodawanego modelu. Ta równowaga — jedna bramka operacyjna z walidacją świadomą modelu — to najbezpieczniejszy sposób na przekształcenie wielomodelowego API w oprogramowanie produkcyjne.