Налаштування Astra API з офіційною автентифікацією OpenAI

Почніть із провайдера та платіжного облікового запису

Використовуйте gpt-6-astra через API OpenAI із власним ключем OpenAI Platform. Для програми почніть із наведеного нижче прикладу Responses. Для локальної роботи з кодом використовуйте команди входу та вибору моделі Codex CLI. Обидва шляхи використовують ваш обліковий запис Platform і спричиняють оплату API за відповідними тарифами OpenAI.

До запуску запиту підтвердьте, кому належить проєкт Platform, чи має його ключ доступ до моделі та які платіжні обмеження діють. Поява моделі в ChatGPT або Codex не надає доступу до кожного проєкту API. У своїх нотатках окремо фіксуйте вхід за підпискою та вхід за ключем API. Ця відмінність критично важлива під час діагностики ліміту або подальшого узгодження списань.

Підготуйте ключ і клієнт у довіреному середовищі

Створіть ключ API на панелі OpenAI та передайте його як OPENAI_API_KEY через приватне середовище або менеджер секретів. Офіційний SDK читає цю змінну. Ніколи не вбудовуйте ключ у JavaScript браузера, публічний репозиторій, знімок екрана чи спільну розшифровку термінала. Під час роботи з обліковими даними вимикайте трасування оболонки.

Для наведеного нижче прикладу JavaScript встановіть офіційний пакет openai у своєму проєкті командою npm install openai. Запишіть установлену версію у lock-файлі. Явний baseURL обирає OpenAI, а не успадковану користувацьку кінцеву точку. Також перевірте наявну конфігурацію агента: перевизначення провайдера та облікові дані іншого сервісу не стають сумісними лише тому, що обидва приймають заголовок Authorization.

Надішліть запит Responses і прочитайте відповідь

Створіть astra-example.mjs із наведеним нижче кодом, а потім виконайте node astra-example.mjs. У prompt запитується короткий контрольний список, щоб ви могли перевірити повернену відповідь до підключення більшого процесу. Автоматичні повтори SDK вимкнено для цього першого запиту, тому помилки з’єднання або облікового запису легше діагностувати.

Коли статус має значення completed, response.output_text містить об’єднаний текстовий результат SDK. Виводьте його до стандартного виводу, щоб інша програма могла його спожити або перенаправити у файл. Метадані відповіді надсилайте до стандартної помилки, щоб відокремити їх від відповіді. Для неповних відповідей збережіть incomplete_details і usage та поверніть ненульовий код завершення.

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
}

Оберіть автентифікацію ключем API для локального Codex

OpenAI документує вхід за ключем API для локальної роботи з Codex. У CLI перевірте статус codex login до зміни облікових даних. Наведена нижче команда stdin не дає вставляти секрет в аргумент команди. Після входу знову перевірте активний спосіб автентифікації, потім виберіть точну модель прапорцем CLI.

Фінальна команда відкриває інтерактивну сесію з вибраною Astra. Почніть у каталозі проєкту, щоб агент читав правильні файли та інструкції репозиторію. Перевірте наявні перевизначення провайдера та підтвердьте активний обліковий запис. Режим ключа API підтримує локальну роботу; Codex cloud потребує автентифікації ChatGPT. Щоб продовжити хмарне завдання локально, спочатку перенесіть робочі файли й короткий підсумок незавершеної роботи у свій локальний проєкт.

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

Узгодьте можливості зі шляхом клієнта

Astra підтримує Responses і Chat Completions, але виклики інструментів потребують Responses. Використовуйте Responses для агента, який виконує функції або користувацькі інструменти. Клієнт, написаний для читання chat choices, не може розібрати результат Responses лише через зміну URL, а текстова перевірка не тестує цикл інструмента.

Додавайте по одній можливості, використовуючи невеликий приклад із програми. Для інструментів перевірте аргументи, виконайте функцію у своїй програмі та поверніть результат через Responses із відповідним call_id. Для структурованого результату перевірте схему й обробіть неповні відповіді. Для потокової передачі опрацьовуйте також події завершення та скасування, а не лише текст. Простий текстовий запит залиште доступним як діагностичний шлях під час додавання функцій.

Окремо діагностуйте збої доступу, частоти та завершення

До повтору використовуйте HTTP-статус і структуровані поля помилки. Посібник з помилок OpenAI розрізняє недійсну автентифікацію, вичерпані кредити, примусові ліміти витрат і надмірну частоту запитів. Зокрема, відповіді 429 недостатньо для вибору засобу: перевірте error.code і відповідні параметри облікового запису.

За тимчасового тиску частоти дотримуйтеся Retry-After, якщо він наданий, і використовуйте обмежені повтори. Збої платежів або ліміту витрат потребують рішення щодо облікового запису, а не повторних запитів. Результат Responses зі статусом incomplete є іншою умовою і вже міг спожити токени. Зберігайте знеособлену інформацію про помилку та usage; не перетворюйте тайм-аут або відсутню квитанцію на успішну чи безкоштовну спробу.

Доступність провайдера та докази: 5 вересня 2026 року

OpenAI оголосила GPT-6 Astra із поетапним розгортанням, а довідка моделі описує офіційний API. Наведені приклади відповідають цим джерелам; для цього посібника не виконувалися платний запит або перемикання автентифікації Codex. Публічна перевірка каталогу APIsRouter 5 вересня 2026 року повернула HTTP 200, success: true і 34 моделі, без Astra або GPT-6.

Використовуйте облікові дані OpenAI лише з показаною вище офіційною кінцевою точкою. Перевіряйте живий каталог APIsRouter щодо його власних пропозицій. Навіть подальша поява Astra у списку потребуватиме перевірки точного ID моделі, ціни та необхідних можливостей клієнта до використання в програмі.

Підключіть відповідь до корисного локального процесу

Оберіть одне локальне завдання з конкретним результатом, наприклад пояснення функції та пропозиція тесту. Надайте агенту відповідний шлях до файла, очікувану поведінку та команду тестування. Після зміни коду перевірте diff і запустіть сфокусовані тести. Зберігайте початковий вхід і повернену відповідь разом, щоб легко порівнювати ревізії.

У програмі передавайте завершений текст на екран перевірки або в конвеєр документів. Якщо наступний крок очікує машинозчитуваних даних, використовуйте структурований результат і перевірте обов’язкові поля до збереження. Зберігайте ідентичність запиту та usage поруч із завданням і встановіть обмежену політику повторів. Розширюйте процес після того, як його базові входи, обробка відповіді та перевірки завершення працюють разом.

Поширені запитання