GPT-6 Astra в OmniaKey

Это руководство проведёт вас от нового аккаунта OmniaKey до первого успешного запроса к GPT-6 Astra. Здесь рассматриваются серверный API и Codex CLI. API-ключ OmniaKey не является подпиской ChatGPT, и его нельзя использовать на сайте ChatGPT.

Текущее руководство OpenAI для Astra начинает работу с Responses API. Chat Completions остаётся доступным для обычного текста, но вызов инструментов Astra требует Responses. Примеры ниже соблюдают эту границу и читают ключ из переменной окружения.

Что нужно подготовить

Создайте API-ключ с ограничениями

Войдите в OmniaKey и откройте страницу API Keys. Создайте отдельный ключ для интеграции, задайте подходящие лимит и срок действия, затем сразу скопируйте его.

На аккаунте также должен быть доступный баланс. Создание ключа подтверждает наличие учётных данных, но не возможность оплатить запрос.

Обращайтесь с ключом как с паролем. Не добавляйте его в Git, клиентский JavaScript, скриншоты или сообщения.

Сохраните ключ в переменной окружения

В macOS или Linux:

export OMNIAKEY_API_KEY="your-omniakey-api-key"

В PowerShell:

$env:OMNIAKEY_API_KEY="your-omniakey-api-key"

Примеры SDK и Codex используют эту же переменную.

Выполните первый запрос Responses API

Запустите в терминале:

curl https://api.omniakey.com/v1/responses \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning": {"effort": "medium"},
    "input": "Проверь этот план миграции. Назови два главных риска и один приёмочный тест для каждого."
  }'

Успешный ответ содержит массив output, сгенерированный текст и расход токенов. Один запрос одновременно проверяет Base URL, ключ, баланс, разрешение модели, ID и маршрут Responses.

После успеха откройте страницу usage и убедитесь, что записана модель gpt-6-astra. Проверяйте фактические input, cached input, reasoning и output, а не оценивайте стоимость только по видимому тексту.

Вызов Astra из Python

Установите или обновите официальный Python SDK OpenAI:

python -m pip install --upgrade openai

Создайте astra_example.py:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OMNIAKEY_API_KEY"],
    base_url="https://api.omniakey.com/v1",
)

response = client.responses.create(
    model="gpt-6-astra",
    reasoning={"effort": "medium"},
    input="Объясни этот отчёт об инциденте и предложи три наиболее полезные проверки.",
)

print(response.output_text)

Запустите:

python astra_example.py

response.output_text предоставляет готовый сгенерированный текст. Сохраняйте полный объект ответа, если нужны usage, status или элементы tool call.

Вызов Astra из Node.js

Установите SDK:

npm install openai

Создайте серверный файл astra-example.mjs:

import OpenAI from "openai";

const apiKey = process.env.OMNIAKEY_API_KEY;
if (!apiKey) throw new Error("OMNIAKEY_API_KEY is required");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.omniakey.com/v1",
});

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "medium" },
  input: "Проверь этот дизайн API. Найди два сценария отказа и тест для каждого.",
});

console.log(response.output_text);

Запустите в терминале с заданной переменной окружения:

node astra-example.mjs

Этот код должен работать на сервере, локальной машине или доверенном worker. Ключ внутри frontend bundle будет доступен посетителям.

GPT-6 Astra в Codex CLI

Codex использует Responses через custom provider. Добавьте в ~/.codex/config.toml:

model = "gpt-6-astra"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

Запустите Codex из shell, где задан ключ:

export OMNIAKEY_API_KEY="your-omniakey-api-key"
codex

Не добавляйте к этому provider requires_openai_auth = true. Этот режим использует авторизацию аккаунта OpenAI, поэтому Codex игнорирует env_key custom provider.

Сначала проверьте модель, которую показывает Codex, затем выполните небольшую задачу только для чтения. Если прямой cURL работает, а Codex нет, сначала проверяйте конфигурацию клиента.

Chat Completions только для совместимых клиентов

GPT-6 Astra принимает обычный текст через Chat Completions. Используйте этот вариант, когда клиент ещё не поддерживает Responses:

curl https://api.omniakey.com/v1/chat/completions \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning_effort": "medium",
    "messages": [
      {"role": "user", "content": "Назови два главных риска в этом плане релиза."}
    ]
  }'

Параметры различаются: Responses использует reasoning.effort, а Chat Completions использует reasoning_effort. Не добавляйте инструменты Astra в этот пример. Текущее руководство OpenAI требует Responses для tool calling.

Выбор reasoning effort

Astra поддерживает low, medium, high, xhigh и max, но не поддерживает none. Больший effort может увеличить рассуждение, задержку и стоимость output-токенов без гарантии правильности. Выбирайте минимальное значение, которое проходит приёмку.

Дайте Astra проверяемую задачу

Хороший первый prompt определяет цель, контекст, ограничения и критерий завершения:

Цель: проверить риск развёртывания этой миграции базы данных.
Контекст: PostgreSQL 15, один production writer, откат должен занять не более пяти минут.
Ограничения: не предлагай разрушительные команды; отделяй проверенные факты от предположений.
Готово, когда: названы три главных риска, мера снижения и приёмочный тест для каждого.

Для программирования также укажите правила репозитория и точную команду проверки. Astra внимательно следует доступным файлам инструкций, поэтому проверьте AGENTS.md, skills и аналогичные файлы до выдачи доступа к инструментам.

Устранение частых ошибок

401, unauthorized или неверный API-ключ

Убедитесь, что OMNIAKEY_API_KEY задан в том же shell, где выполняется команда. Переменная содержит только ключ; слово Bearer добавляется в HTTP header. Проверьте, что ключ включён и не истёк.

Недостаточный баланс или quota

Проверьте баланс аккаунта и собственный лимит ключа. Даже оплаченный аккаунт не поможет ключу, который исчерпал свой cap.

Модель не найдена или недоступна

Используйте точный ID gpt-6-astra. Откройте живую страницу модели и проверьте разрешение ключа. Название GPT 6 не является API ID.

Неподдерживаемый параметр

Удалите temperature, top_p и top_logprobs. Для Chat Completions также удалите logprobs, а из Responses include удалите message.output_text.logprobs. Astra не поддерживает эти параметры.

Ответ incomplete или без видимого текста

Увеличьте max_output_tokens и проверьте output_tokens_details.reasoning_tokens. Reasoning-токены занимают output budget до завершения видимого ответа.

Чат работает, а инструменты нет

Перенесите workflow на /v1/responses. Сначала проверьте обычный текст, затем добавляйте по одному инструменту и проверяйте request, result, timeout и permission path. Официальный список OpenAI описывает прямые возможности модели; шлюз или клиент может предоставлять меньший набор.

Codex продолжает использовать другую модель

Проверьте model, model_provider, base_url, env_key и wire_api в активной конфигурации Codex. Перезапустите Codex из shell с заданным OMNIAKEY_API_KEY.

Проверьте стоимость до production

Выполните одну репрезентативную задачу, проверьте usage и включите повторы в полную стоимость. Живая страница Astra содержит текущую цену OmniaKey, а обзор Astra отделяет её от прямых тарифов OpenAI и объясняет прямой порог 272K.

Ссылки

• OpenAI: модель GPT-6 Astra
• OpenAI: Using GPT-6 Astra
• Быстрый старт API OmniaKey
• OpenAI-совместимый API OmniaKey
• Руководство OmniaKey для Codex CLI