GPT-6.2 Astra APIの使い方を徹底解説

GPT-6.2 Astra API実践ガイド:初めてのリクエスト、reasoning effortの選び方、関数呼び出し、料金面での落とし穴、そしてGPT-6 Astraからの移行方法を解説します。

Medy Evrard

18 11月 2026

GPT-6.2 Astra APIの使い方を徹底解説

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

クイック回答: GPT-6.2 Astra API を使うには、OpenAI の Responses エンドポイント(POST /v1/responses)に、"model": "gpt-6.2-astra"、"high" などの reasoning effort、そして入力を指定してリクエストを送ります。料金は入力トークン100万あたり8ドル、出力トークン100万あたり40ドルで、入力は最大922Kトークン、出力は最大128Kトークンに対応しています。effort を none に設定しないでください。API に拒否されます。

OpenAI は2026年11月17日に、GPT-6.2 Astra と、その低価格版である GPT-6.2 Sol をリリースしました。以前に GPT-6 Astra を呼び出したことがあれば、コードの大部分はそのまま使えます。このガイドでは、GPT-6.2 Astra API の最初のリクエストから、ツール呼び出し、effort の調整、料金の落とし穴、そしてコーディングエージェントに実行させる再現性のあるテストまでを順に解説します。

最初の GPT-6.2 Astra API 呼び出しの前に必要なもの

必要なものは4つあり、おそらく3つはすでに手元にあるはずです:

  1. プラットフォームダッシュボードから取得した OpenAI API キー。OPENAI_API_KEY としてエクスポートします。
  2. 有料の利用ティア。 OpenAI のモデルページでは、Astra のレート制限は Build ティア(毎分5,000リクエスト、100万トークン)から記載されています。
  3. モデル ID gpt-6.2-astra。低価格モデルは gpt-6.2-sol です。
  4. 対応エンドポイント: Responses、Chat Completions、または Batch。Realtime、Assistants、ファインチューニングはどちらのモデルにも対応していません。

これらの仕様は OpenAI の GPT-6.2 Astra モデルページによるもので、2026年11月18日時点で確認済みです。

仕様 GPT-6.2 Astra
モデル ID gpt-6.2-astra
コンテキストウィンドウ 1,050,000 トークン
最大入力 922,000 トークン
最大出力 128,000 トークン
ナレッジカットオフ 2026年5月18日
エンドポイント Responses、Chat Completions、Batch
機能 ストリーミング、関数呼び出し、構造化出力、画像入力、プロンプトキャッシュ

最初の GPT-6.2 Astra API リクエストの送り方

Responses API は OpenAI が新機能を追加していくエンドポイントなので、まずはここから始めましょう。手順は以下の通りです:

  1. キーをエクスポート:export OPENAI_API_KEY=sk-...
  2. モデル ID と effort レベルを指定してリクエストを送信。
  3. 回答は output_text、トークン数は usage から読み取る。

curl の場合:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.2-astra",
    "reasoning": { "effort": "high" },
    "input": "Review this migration plan and list the three biggest risks."
  }'

公式 Python SDK の場合(pip install --upgrade openai):

from openai import OpenAI

client = OpenAI()  # reads OPENAI_API_KEY

response = client.responses.create(
    model="gpt-6.2-astra",
    reasoning={"effort": "high"},
    input="Review this migration plan and list the three biggest risks.",
)

print(response.output_text)
print(response.usage)

Node.js の場合(npm install openai):

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6.2-astra",
  reasoning: { effort: "high" },
  input: "Review this migration plan and list the three biggest risks.",
});

console.log(response.output_text);

最初のうちは、毎回 usage ブロックを確認してください。Astra は一言目を書き出す前に reasoning トークンを消費し、それは出力として課金されます。短い回答でも想定より高くつくことがあります。

Diagram of a GPT-6.2 Astra API request: a POST to /v1/responses carrying model, reasoning effort, tools and input, returning output text, tool calls and a usage block with input, output and reasoning tokens

GPT-6.2 Astra の reasoning effort を選ぶ

Reasoning effort は、品質とコストの両方に影響する最大の要素です。OpenAI の reasoning ガイドでは、none、minimal、low、medium、high、xhigh、max という値が挙げられており、各モデルはその一部のみに対応するとされています。GPT-6.2 Astra と Sol について確認されている唯一のルールは、none が拒否されるため、すべての呼び出しで何らかの reasoning が行われる、というものです。

Effort 向いている用途
low / medium シンプルな編集、抽出、短い回答
high コードレビュー、計画、難易度の高いほとんどのプロンプト。テスト開始時の現実的なデフォルト値
xhigh 長時間のエージェント実行や非同期処理。評価で明確な利点が確認できた場合のみ
max 最難問。より良い回答が数倍のトークンコストに見合う場合

OpenAI は Astra のデフォルト effort を明示していないため、すべてのリクエストで明示的に設定しましょう。それにより、請求額とテスト結果の再現性が保たれます。

effort によって請求額はどのくらい変わるのでしょうか?Simon Willison がリリース日に、同じ画像プロンプトを3つの effort レベルで各モデルに実行し、そのコストを公開しました。Astra のコストは high で11.55セント、xhigh で17.70セント、max で88.71セントでした。high から max に上げるだけでコストは約8倍になりました。

Bar chart of cost per run in US cents for gpt-6.2-astra, gpt-6.2-sol, gpt-6-astra and gpt-6.1-sol at high, xhigh and max effort: Astra 6.2 rises from 11.55 at high to 88.71 at max, Sol 6.2 from 2.41 to 13.69

注目すべきは、GPT-6.2 Astra は high と xhigh では GPT-6 Astra より安かったものの、max では高かったという点です。トークン単価は20%下がりましたが、max effort ではより長く思考するためです。見るべきは100万トークンあたりのコストではなく、完了したタスクごとのコストです。

GPT-6.2 Astra API でのツールと構造化出力の利用

Astra は、Responses API において関数呼び出し、構造化出力、多数のホスト型ツール(ウェブ検索、ファイル検索、画像生成、コードインタプリタ、ホスト型シェル、apply patch、skills、computer use、MCP、tool search)をサポートしています。

関数ツールは GPT-6 Astra の頃と同じ形式です:

response = client.responses.create(
    model="gpt-6.2-astra",
    reasoning={"effort": "high"},
    tools=[{
        "type": "function",
        "name": "get_order_status",
        "description": "Look up an order by its ID.",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    }],
    input="Where is order A-1042?",
)

for item in response.output:
    if item.type == "function_call":
        print(item.name, item.arguments)

関数は自分で実行し、その結果を対応する call_id を持つ function_call_output アイテムとして返します。Astra はそれをもとに最終的な回答を生成します。

機械可読な出力が必要な場合は、text.format に "type": "json_schema" と "strict": true を指定した JSON スキーマを渡します。モデルはスキーマに一致する JSON を返すため、推測なしにパースできます。

これだけ高性能なモデルを使ううえで、2つの習慣が役立ちます。第一に、各ツールに簡潔な説明と厳格なスキーマを与えること。リリース日のレビューでは、Astra が長く自由度の高いタスクで脱線することがあると報告されています。第二に、エージェントのループには max_output_tokens を設定し、暴走した1ステップが予算を食いつぶさないようにすることです。エンドポイント自体については、OpenAI Responses API ガイドを参照してください。

GPT-6.2 Astra API の料金とレート制限

Astra は100万トークン単位で課金され、非常に長いプロンプトには追加料金がかかります。以下のレートはモデルページによるものです:

項目 GPT-6.2 Astra GPT-6 Astra(参考)
入力 $8.00 $10.00
キャッシュ済み入力 $0.40 $1.00
キャッシュ書き込み(30分保持) $10.00 なし
出力 $40.00 $50.00

落とし穴は長文コンテキストのルールです。リクエストの入力トークンが272Kを超えると、そのリクエスト全体に対して入力とキャッシュのレートが2倍になり、出力は1.5倍になります。300Kトークンのプロンプトは、272Kを超えた部分だけでなく、リクエスト全体が入力 $16・出力 $60 で課金されます。Astra にリポジトリ全体を丸ごと渡すなら、可能な範囲で272K未満にチャンク化するかキャッシュを利用しましょう。

Batch ジョブは、時間を待てる評価やバックフィルに向いています。VentureBeat によると、Batch は半額で実行できます。

ティア別の標準レート制限:

ティア リクエスト/分 トークン/分
Build 5,000 1,000,000
Launch 10,000 4,000,000
Grow 15,000 40,000,000

429 レスポンスには指数バックオフで対応してください。xhigh での長時間のエージェント実行は、Build ティアのトークン予算をあっという間に使い切る可能性があります。

GPT-6 Astra から GPT-6.2 Astra への移行

ほとんどのコードで必要な変更は1つ、モデル文字列です。本番環境で切り替える前に、以下を確認してください:

初期の評価は賛否あり、切り替え前にテストしましょう。VentureBeat のまとめによると、Ethan Mollick は Astra を「非常にムラがあり、奇妙だ」と評し、Dan Shipper はエンドツーエンドのビルドで早々に停止することが多いと指摘しました。一方で、コードレビューと computer use を高く評価する声もあります。最終的に意味を持つのは、自分自身のプロンプトによるベンチマークだけです。GPT-6 Astra API ガイドでは前世代から引き継がれる内容を解説しており、トラフィックの大半が定型処理であれば、GPT-6.1 Sol API ガイドで低価格ティアのリクエスト形式を確認できます。

Apidog CLI でコーディングエージェントに GPT-6.2 Astra をテストさせる

ターミナルにプロンプトを貼り付ける方法は、その日の Astra の出来栄えは教えてくれますが、来月アップデートによってスキーマが壊れたときは教えてくれません。チェックをコーディングエージェントに構築させ、Apidog CLI で実行させましょう。あなたが書くのはプロンプト1つだけです。

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

そして、Claude Code、Codex、Cursor に次のプロンプトを1つ与えます:

In Apidog project <projectId>, create a test case for POST https://api.openai.com/v1/responses
with model "gpt-6.2-astra", reasoning effort "high" and a get_order_status function tool.
Assert status 200, that the output contains a function_call named get_order_status,
that its arguments parse as JSON with an order_id, and that usage.output_tokens is under 4000.
Read the API key from the OPENAI_API_KEY variable in environment <envId>, then run it.

エージェントはペイロードのスキーマを読み、スキーマファイルを検証し、テストケースを作成して実行します:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

API キーはプロンプト内ではなく Apidog の環境変数に置きましょう。エージェントのコンテキストに残らないようにするためです。--upload-report を付けると Apidog アプリ上で実行結果を確認でき、-n 5 を付けると繰り返し実行して Astra のツール呼び出しの安定性を確認できます。パイプラインに -r junit を組み込めば、デプロイのたびにチェックが再実行されます。セットアップは CI/CD での Apidog CLI ガイド、エージェント側の設定は Claude Code での Apidog CLI を参照してください。Apidog の Free プランは最大4ユーザーのチームまで利用できます。

FAQ

GPT-6.2 Astra API のモデル ID は? gpt-6.2-astra です。低価格版は gpt-6.2-sol です。どちらも Responses、Chat Completions、Batch エンドポイントで利用できます。

GPT-6.2 Astra API の料金は? 入力トークン100万あたり8ドル、キャッシュ済み入力トークン100万あたり0.40ドル、出力トークン100万あたり40ドルです。入力272Kトークンを超えるリクエストは、リクエスト全体に対して入力2倍・出力1.5倍の料金がかかります。

GPT-6.2 Astra のリクエストが reasoning effort none で失敗するのはなぜ? 両 GPT-6.2 モデルは "effort": "none" を拒否します。high を設定するか、テストで自分のタスクに有効と確認できた最低レベルを設定してください。

GPT-6.2 Astra のコンテキストウィンドウは? 合計1,050,000トークンで、最大入力922,000トークン、最大出力128,000トークンです。

GPT-6.2 Astra は Chat Completions API で使えますか? はい。対応していますが、ウェブ検索、computer use、apply patch などのホスト型ツールは Responses API 向けに記載されているため、エージェント開発では Responses を使いましょう。

GPT-6.2 Astra は無料で使えますか? API では無理です。すべての呼び出しに課金されます。ChatGPT Work と Codex では、OpenAI のリリース発表によると、Plus、Pro、Enterprise、Edu プランに含まれています。

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる