Konfiguracja API Astra z oficjalnym uwierzytelnianiem OpenAI

Zacznij od dostawcy i konta rozliczeniowego

Używaj gpt-6-astra przez API OpenAI z własnym kluczem OpenAI Platform. W aplikacji zacznij od przykładu Responses poniżej. Do lokalnej pracy z kodem użyj poleceń logowania i wyboru modelu Codex CLI. Obie ścieżki korzystają z konta Platform i powodują naliczanie opłat API według właściwych stawek OpenAI.

Przed uruchomieniem żądania potwierdź, kto jest właścicielem projektu Platform, czy jego klucz może uzyskać dostęp do modelu i jakie kontrole rozliczeń mają zastosowanie. Pojawienie się modelu w ChatGPT lub Codex nie daje dostępu do każdego projektu API. W notatkach z uruchomienia oddziel logowanie subskrypcji od logowania kluczem API. To rozróżnienie jest niezbędne przy diagnozowaniu limitu lub późniejszym uzgadnianiu opłat.

Przygotuj klucz i klienta w zaufanym środowisku

Utwórz klucz API w panelu OpenAI i przekaż go jako OPENAI_API_KEY przez prywatne środowisko lub menedżer sekretów. Oficjalny SDK odczytuje tę zmienną. Nigdy nie osadzaj klucza w JavaScript uruchamianym w przeglądarce, publicznym repozytorium, zrzucie ekranu ani udostępnionej transkrypcji terminala. Podczas obsługi danych uwierzytelniających unikaj śledzenia poleceń.

W poniższym przykładzie JavaScript zainstaluj oficjalny pakiet openai w projekcie poleceniem npm install openai. Zapisz zainstalowaną wersję w lockfile. Jawny baseURL wybiera OpenAI zamiast odziedziczonego niestandardowego endpointu. Przejrzyj także istniejącą konfigurację agenta: nadpisanie dostawcy i dane uwierzytelniające innej usługi nie stają się zgodne tylko dlatego, że obie przyjmują nagłówek Authorization.

Wyślij żądanie Responses i odczytaj odpowiedź

Utwórz plik astra-example.mjs z poniższym kodem, a następnie uruchom node astra-example.mjs. Prompt prosi o krótką listę kontrolną, aby można było przejrzeć zwróconą odpowiedź przed podłączeniem większego procesu. Automatyczne ponowienia SDK są wyłączone dla tego pierwszego żądania, dzięki czemu błędy połączenia lub konta łatwiej zdiagnozować.

Gdy status to completed, response.output_text zawiera połączony tekst wyjściowy SDK. Wypisz go na standardowe wyjście, aby inny program mógł go odczytać albo przekierować do pliku. Metadane odpowiedzi wysyłaj na standardowe wyjście błędów, aby oddzielić je od odpowiedzi. W przypadku niepełnych odpowiedzi zachowaj incomplete_details i usage oraz zwróć niezerowy kod wyjścia.

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

Wybierz uwierzytelnianie kluczem API dla lokalnego Codex

OpenAI dokumentuje logowanie kluczem API do lokalnej pracy z Codex. W CLI przed zmianą danych uwierzytelniających sprawdź status logowania Codex. Udokumentowane polecenie stdin poniżej nie wymaga wklejania sekretu jako argumentu. Po zalogowaniu ponownie sprawdź aktywną metodę uwierzytelniania, a następnie wybierz dokładny model za pomocą flagi modelu CLI.

Końcowe polecenie otwiera interaktywną sesję z wybraną Astrą. Uruchom ją w katalogu projektu, aby agent mógł odczytać właściwe pliki i instrukcje repozytorium. Przejrzyj istniejące nadpisania dostawcy i potwierdź aktywne konto. Tryb klucza API obsługuje pracę lokalną; Codex cloud wymaga uwierzytelniania ChatGPT. Jeśli chcesz kontynuować zadanie chmurowe lokalnie, najpierw przenieś pliki robocze i krótkie podsumowanie pozostałej pracy do lokalnego projektu.

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

Dopasuj możliwości do ścieżki klienta

Astra obsługuje Responses i Chat Completions, ale wywoływanie narzędzi wymaga Responses. Użyj Responses dla agenta wykonującego funkcje lub własne narzędzia. Klient napisany do odczytywania wyborów czatu nie przeanalizuje wyniku Responses przez samą zmianę URL, a tekstowy smoke test nie uruchamia pętli narzędzi.

Dodawaj po jednej możliwości, korzystając z małego przykładu z aplikacji. W przypadku narzędzi zweryfikuj argumenty, uruchom funkcję w aplikacji i zwróć wynik przez Responses z pasującym call_id. W przypadku ustrukturyzowanego wyniku zweryfikuj schemat i obsłuż niepełne odpowiedzi. Przy streamingu obsłuż zarówno zdarzenia ukończenia i anulowania, jak i tekst. Prostą prośbę tekstową zachowaj jako ścieżkę diagnostyczną podczas dodawania tych funkcji.

Oddzielnie diagnozuj dostęp, limity i nieukończone odpowiedzi

Przed ponowieniem użyj statusu HTTP i ustrukturyzowanych pól błędu. Przewodnik błędów OpenAI rozróżnia nieprawidłowe uwierzytelnianie, wyczerpane kredyty, egzekwowane limity wydatków i presję na limit żądań. W szczególności sama odpowiedź 429 nie wystarcza do wyboru rozwiązania: sprawdź error.code i odpowiednie ustawienia konta.

Przy chwilowym nacisku na limit żądań respektuj Retry-After, jeśli występuje, i używaj ograniczonych ponowień. Błędy rozliczeń lub limitów wydatków wymagają decyzji dotyczącej konta, a nie kolejnych żądań. Wynik Responses oznaczony jako nieukończony jest jeszcze innym warunkiem i mógł już zużyć tokeny. Zachowaj zredagowane informacje o błędzie i użyciu; nie uznawaj timeoutu ani brakującego potwierdzenia za udaną lub bezpłatną próbę.

Dostępność dostawcy i dowody: 5 września 2026 r.

OpenAI ogłosiło GPT-6 Astra z etapowym wdrożeniem, a dokumentacja modelu opisuje oficjalne API. Przykłady tutaj są zgodne z tymi źródłami; na potrzeby tego przewodnika nie wykonano płatnego żądania ani zmiany uwierzytelniania Codex. Publiczna kontrola katalogu APIsRouter 5 września 2026 r. zwróciła HTTP 200, success: true i 34 modele, bez wpisu Astry lub GPT-6.

Używaj danych uwierzytelniających OpenAI wyłącznie z pokazanym wyżej oficjalnym endpointem. Sprawdź działający katalog APIsRouter pod kątem jego własnych ofert. Późniejsza obecność Astry na liście nadal wymaga sprawdzenia dokładnego identyfikatora modelu, ceny i funkcji klienta potrzebnych przed użyciem jej w aplikacji.

Połącz odpowiedź z użytecznym lokalnym procesem

Wybierz jedno lokalne zadanie z konkretnym wynikiem, na przykład wyjaśnienie funkcji i propozycję testu. Przekaż agentowi odpowiednią ścieżkę pliku, oczekiwane zachowanie i polecenie testowe. Po zmianie kodu przejrzyj diff i uruchom testy skupione na tym obszarze. Oryginalne dane wejściowe i zwróconą odpowiedź przechowuj razem, aby łatwo porównywać rewizje.

W aplikacji przekaż ukończony tekst do ekranu przeglądu lub pipeline'u dokumentów. Jeśli kolejny etap oczekuje danych możliwych do odczytu maszynowego, użyj ustrukturyzowanego wyniku i zweryfikuj wymagane pola przed zapisaniem. Tożsamość żądania i użycie przechowuj obok zadania, ustawiając ograniczoną politykę ponowień. Rozszerz proces dopiero, gdy jego podstawowe dane wejściowe, obsługa odpowiedzi i kontrole ukończenia działają razem.

Częste pytania