OmniaKeyでGPT-6 Astraを使う方法

このチュートリアルでは、新しいOmniaKeyアカウントから最初のGPT-6 Astraリクエストが成功するまでを説明します。対象はサーバー側のAPI呼び出しとCodex CLIです。OmniaKeyのAPIキーはChatGPTのサブスクリプションではなく、ChatGPTのWebサイトに入力して使うものではありません。

OpenAIの現行AstraガイドはResponses APIから始めています。通常のテキストならChat Completionsも利用できますが、Astraのツール呼び出しにはResponsesが必要です。以下の例はこの境界を守り、キーをソースコードへ書かずに環境変数から読み込みます。

始める前の準備

用途を限定したAPIキーを作る

OmniaKeyへログインし、APIキー画面を開きます。この連携専用のキーを作成し、テストに合う上限と有効期限を設定してください。キーが表示された時点で控えます。

アカウントには利用可能な残高も必要です。キーを作成できたことは認証情報が存在する証明にすぎず、リクエスト料金を支払えることまでは証明しません。

キーはパスワードと同様に扱ってください。Gitへコミットしたり、ブラウザー用アプリに埋め込んだり、スクリーンショットやチャットへ載せたりしないでください。

キーを環境変数へ入れる

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": "この移行計画をレビューし、最大のリスクを2つと、それぞれの受け入れテストを1つ返してください。"
  }'

成功したレスポンスにはoutput配列、生成テキスト、トークン使用量が含まれます。この1回の呼び出しで、Base URL、キー、残高、モデル権限、モデルID、Responsesルートをまとめて確認できます。

成功後は使用量画面を開き、記録されたモデルがgpt-6-astraであることを確認してください。画面に見える文章量だけで費用を推測せず、実際の入力、キャッシュ入力、推論、出力の使用量を見ます。

PythonからAstraを呼び出す

OpenAI公式Python SDKをインストールまたは更新します。

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="このインシデント報告を説明し、次に行うべき確認を3つ挙げてください。",
)

print(response.output_text)

実行します。

python astra_example.py

response.output_textは生成テキストを取り出すSDKの便利なフィールドです。使用量、状態、ツール呼び出し項目も必要なら、レスポンス全体を保持してください。

Node.jsからAstraを呼び出す

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設計をレビューし、障害パターンを2つと、それぞれのテストを1つ挙げてください。",
});

console.log(response.output_text);

環境変数を設定したシェルから実行します。

node astra-example.mjs

このコードはサーバー、ローカルマシン、または信頼できるワーカーで実行してください。フロントエンドのbundleに入ったキーは訪問者から読み取れます。

Codex CLIでGPT-6 Astraを使う

CodexのカスタムproviderはResponses wire formatを使います。ユーザー設定の~/.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を起動します。

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

requires_openai_authは設定しません。Codexの公式設定リファレンスでは、これはOpenAI認証を使うためのフラグです。このカスタムproviderは代わりにenv_keyで認証します。

まず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": "このリリース計画の主なリスクを2つ要約してください。"}
    ]
  }'

パラメーター名に注意してください。Responsesではreasoning.effort、Chat Completionsではreasoning_effortを使います。このChat Completions例へAstraのツールを追加しないでください。OpenAIの現行ガイドでは、Astraのツール呼び出しにResponsesが必要です。

reasoning effortを選ぶ

Astraはlow、medium、high、xhigh、maxに対応し、noneには対応しません。高いeffortは、正解を保証しないまま推論量、遅延、出力トークン料金を増やす場合があります。受け入れテストを通る最低の設定を使ってください。

Astraへ検証可能なタスクを渡す

良い最初のプロンプトには、目標、関連するコンテキスト、制約、完了条件を明記します。

目標：このデータベース移行のデプロイリスクをレビューする。
コンテキスト：PostgreSQL 15、本番のwriterは1つ、ロールバックは5分以内に完了する必要がある。
制約：破壊的なコマンドを提案しない。確認済みの事実と仮定を区別する。
完了条件：上位3つのリスクと、それぞれに緩和策1つ、受け入れテスト1つを返す。

コーディング作業では、リポジトリのルールと完了を証明する正確なコマンドも指定します。Astraはアクセス可能な指示ファイルを注意深く参照するため、ツールアクセスを与える前にAGENTS.md、skills、同様のファイルを確認してください。

よくある設定エラーを直す

401、unauthorized、APIキー無効

コマンドを実行する同じシェルでOMNIAKEY_API_KEYが設定されているか確認します。環境変数にはキーだけを入れ、BearerはHTTPヘッダーだけに付けます。キーが有効で、期限切れでないことも確認してください。

残高または上限が足りない

アカウント残高とキー自身の上限を両方確認します。アカウントに残高があっても、用途限定キーが上限へ達していれば失敗します。

モデルが見つからない、または利用できない

正確な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を確認します。推論トークンは表示回答が完成する前に出力予算を消費します。

チャットは動くがツールが失敗する

ワークフローを/v1/responsesへ移してください。まず通常テキストのResponses呼び出しを確認し、その後ツールを1つずつ追加して、リクエスト、結果、タイムアウト、権限経路を検証します。OpenAI公式のツール一覧はモデル直結時の能力を示すため、ゲートウェイやクライアントが公開する範囲はより狭い場合があります。

Codexが別のモデルを使い続ける

有効なCodex設定のmodel、model_provider、base_url、env_key、wire_apiを確認します。その後、OMNIAKEY_API_KEYを設定したシェルからCodexを再起動してください。

本番前にコストを確認する

代表的なタスクを1つ実行し、使用量の記録を確認して、再試行も総コストへ含めます。Astraモデルページが現在のOmniaKey価格を管理しています。Astraレビューでは、ゲートウェイ価格とOpenAI直結料金を分け、直結料金が変わる272Kの境界を説明しています。

利用上限で作業が止まった場合は、Codex の利用制限への対処ガイドでリセット時刻の確認方法と、追加クレジット・プラン変更・別料金のローカル API 利用を比較できます。

参考資料

以下のOpenAI公式資料はすべて英語です。OmniaKeyドキュメントも現在は英語ページへ移動します。

• OpenAI：GPT-6 Astraモデル
• OpenAI：GPT-6 Astraの利用ガイド
• OpenAI：Codex設定リファレンス
• OmniaKey APIクイックスタート（英語）
• OmniaKey OpenAI互換API（英語）
• OmniaKey Codex CLIガイド（英語）