
GPT-6 Astra API の使い方:最初の呼び出し、effort レベル、GPT-5.6 からの移行

gpt-6-astra で、GPT-5.6 と同じ OpenAI 互換エンドポイントと API キーから、OpenAI 定価の 10% 引きで利用できます。configuration_update、キャッシュオプション 30m の対応は確認できません。利用前に EvoLink の対象ルートで各機能を個別に検証してください。クイックリファレンス
| 項目 | 値 |
|---|---|
| モデル ID | gpt-6-astra(OpenAI にも EvoLink にも gpt-6 エイリアスはなし) |
| エンドポイント | https://api.evolink.ai/v1(OpenAI 互換) |
| API サーフェス(OpenAI) | Responses、Chat Completions(ツール呼び出し非対応)、Batch。EvoLink の機能対応は別途検証が必要 |
| コンテキストウィンドウ | 入力と出力で共有する 1,050,000 トークン。最大入力 922,000、最大出力 128,000 |
| 入力 / 出力 | テキストと画像を入力、テキストを出力 |
| 知識カットオフ | 2026年4月30日 |
| 推論 effort | low、medium、high、xhigh、max。none と minimal は 400 を返す |
| 削除されたパラメータ | temperature、top_p、logprobs |
| プロンプトキャッシュ | 対応。キャッシュ書き込みは入力の 1.25 倍、TTL オプションは 30m |
| OpenAI 定価(入力 ≤ 272K) | 100万トークンあたり入力 $10 / キャッシュ $1 / キャッシュ書き込み $12.50 / 出力 $50 |
| 長文コンテキスト帯(入力 > 272K) | リクエスト全体が入力とキャッシュ 2 倍、出力 1.5 倍 |
| EvoLink 料金 | OpenAI 定価の 10% 引き。現在の数値は API ページ |
| 非対応 | ファインチューニング、Realtime、Assistants、Embeddings、画像・音声生成 |
セットアップと最初のリクエスト
ステップ 1:EvoLink API キーを取得する
ステップ 2:OpenAI SDK をインストールする
pip install openai # Python
npm install openai # Node.jsステップ 3:最初のリクエストを送る
まず基本的な Responses リクエストから始めてください。OpenAI ではツール呼び出しに Responses が必要です。高度な Responses 機能は EvoLink の対象ルートで個別に検証する必要があります。
curl https://api.evolink.ai/v1/responses \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"input": "キャッシュ読み取りとキャッシュ書き込みの違いを 1 段落で説明してください。",
"reasoning": {"effort": "medium"}
}'from openai import OpenAI
client = OpenAI(
api_key="your-evolink-api-key",
base_url="https://api.evolink.ai/v1",
)
response = client.responses.create(
model="gpt-6-astra",
input="キャッシュ読み取りとキャッシュ書き込みの違いを 1 段落で説明してください。",
reasoning={"effort": "medium"},
)
print(response.output_text)
print(response.model, response.usage)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "your-evolink-api-key",
baseURL: "https://api.evolink.ai/v1",
});
const response = await client.responses.create({
model: "gpt-6-astra",
input: "キャッシュ読み取りとキャッシュ書き込みの違いを 1 段落で説明してください。",
reasoning: { effort: "medium" },
});
console.log(response.output_text);
console.log(response.model, response.usage);response.model と response.usage を出力してください。返却されるモデル文字列は gpt-6-astra で、usage ブロックには入力、キャッシュ、推論、出力のトークン数が入ります。請求額との突き合わせにはこれが必要です。Chat Completions でのテキストのみのリクエスト
temperature、top_p、tools は渡さないでください:response = client.chat.completions.create(
model="gpt-6-astra",
messages=[{"role": "user", "content": "この変更履歴を 3 つの箇条書きに要約してください:..."}],
reasoning_effort="low",
)
print(response.choices[0].message.content)Chat Completions と Responses API の違い
| 機能 | Chat Completions | Responses API |
|---|---|---|
| テキスト入力、テキスト出力 | 対応 | 対応 |
| 画像入力 | 対応 | 対応 |
| ストリーミング | 対応 | 対応 |
| 構造化出力 | 対応 | 対応 |
| プロンプトキャッシュ | 対応 | 対応 |
| Function / ツール呼び出し | 非対応 | 対応 |
| 非同期ツール呼び出し | 非対応 | 対応 |
ターン途中のステアリング(WebSocket 経由の response.steer) | 非対応 | 対応 |
キャッシュを保持したまま会話途中で effort を変更(configuration_update) | 非対応 | 対応 |
reasoning.mode: "pro" | 非対応 | 対応 |
temperature、top_p、logprobs | 拒否 | 拒否 |
エージェントループが今 Chat Completions にあるなら、Responses に移すか、Chat Completions でもツール呼び出しに対応している GPT-5.6 に留めてください。
previous_response_id が機能しません。会話履歴は input に明示的に含めてください。推論 effort の選び方
none や minimal を使っていたなら low から始めて比較せよ、というものです。リリース直後に移行ログを公開した開発者たちは、コーディング作業ではデフォルトの起点として medium に収束しました。これはコミュニティの報告であり、EvoLink の測定ではありません。| Effort | 向いている用途 | 注意点 |
|---|---|---|
low | 抽出、分類、短い書き換え、GPT-5.6 で none で動かしていたもの | 推論トークンは発生する。無料枠ではない |
medium | コーディングタスク、複数ステップのツール利用、ドキュメント作業のデフォルト | サードパーティの実行では、low からの品質向上が大きく、コスト増は穏やか |
high | リポジトリ規模の変更、長いリサーチチェーン | 最初のトークンまでの時間とトークン消費が急増 |
xhigh | high で受け入れテストに落ちる難しいエージェントタスク | 高コスト。自社の評価セットで検証 |
max | 制約のない推論予算 | サードパーティの測定では最初のトークンまで数分。オフラインバッチ以外で見合うことは稀 |
OpenAI は次の 2 つの追加制御を文書化しています。EvoLink での対応は未検証のため、提供元 API の参考情報として扱ってください。
configuration_updateを使うと、Responses の会話でプロンプトキャッシュを無効にせずにターン間で effort を変えられます。mediumから始め、失敗したターンだけ上げてください。reasoning.mode: "pro"は Responses API の別個の品質モードです。6 番目の effort ではなく、独立した評価候補として扱ってください。
Responses でリクエストごとに effort を設定する:
response = client.responses.create(
model="gpt-6-astra",
input=[{"role": "user", "content": "このモジュールをリファクタリングし、各変更を説明してください。"}],
reasoning={"effort": "high"},
max_output_tokens=8000,
)Responses API でのツール呼び出し
function_call アイテムを返すことがあるので、実行して結果を function_call_output として返します。tools = [{
"type": "function",
"name": "get_build_status",
"description": "指定ブランチの最新 CI ビルドの状態を返す。",
"parameters": {
"type": "object",
"properties": {"branch": {"type": "string"}},
"required": ["branch"],
},
}]
first = client.responses.create(
model="gpt-6-astra",
input=[{"role": "user", "content": "main ブランチはグリーンですか?そうでなければ失敗を要約してください。"}],
tools=tools,
reasoning={"effort": "medium"},
)
calls = [item for item in first.output if item.type == "function_call"]
outputs = []
for call in calls:
# ここでツールを実行する
outputs.append({
"type": "function_call_output",
"call_id": call.call_id,
"output": '{"status": "failed", "step": "unit-tests", "log_url": "https://ci.example/123"}',
})
second = client.responses.create(
model="gpt-6-astra",
input=[{"role": "user", "content": "main ブランチはグリーンですか?そうでなければ失敗を要約してください。"}]
+ list(first.output) + outputs,
tools=tools,
reasoning={"effort": "medium"},
)
print(second.output_text)"async": true を指定すると、ツール実行中もモデルが推論を続けられます。EvoLink での対応は未検証です。同期ループの成功だけでは非同期呼び出しへの対応は確認できません。構造化出力とストリーミング
text.format で JSON Schema を渡します:response = client.responses.create(
model="gpt-6-astra",
input="このテキストからモデル ID、コンテキストウィンドウ、出力上限を抽出してください:...",
text={
"format": {
"type": "json_schema",
"name": "model_spec",
"schema": {
"type": "object",
"properties": {
"model_id": {"type": "string"},
"context_tokens": {"type": "integer"},
"max_output_tokens": {"type": "integer"},
},
"required": ["model_id", "context_tokens", "max_output_tokens"],
"additionalProperties": False,
},
"strict": True,
}
},
reasoning={"effort": "low"},
)
print(response.output_text)stream=True です。高い effort では最初のトークンまで数十秒かかることがあるので、対話パスでは必ずストリーミングし、推論中は進捗を表示してください。GPT-5.6 からの移行
次の表は OpenAI の移行要件です。EvoLink でトラフィックを切り替える前に、リクエストの各フィールドとオプション機能を検証してください。モデル ID の変更だけでは互換性を確認できません。
| 変更 | GPT-5.6 | GPT-6 Astra |
|---|---|---|
| モデル ID | gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna | gpt-6-astra |
| サンプリングパラメータ | temperature、top_p を受け付ける | 削除する。残すとリクエストは 400 で失敗 |
推論 effort none / minimal | 受け付ける | low に置き換える |
| ツール呼び出しのサーフェス | Chat Completions または Responses | Responses のみ |
| プロンプトキャッシュのオプション | prompt_cache_retention | prompt_cache_options: {"ttl": "30m"} |
| Zero Data Retention 下の会話状態 | previous_response_id | 履歴を input で送る |
| Codex CLI | 最近のバージョンなら可 | 0.153.0 以上 |
典型的な Chat Completions 呼び出しの diff:
response = client.chat.completions.create(
- model="gpt-5.6-sol",
+ model="gpt-6-astra",
messages=messages,
- temperature=0.2,
- reasoning_effort="none",
+ reasoning_effort="low",
)AGENTS.md のようなファイル内の指示をより忠実に守り、リストと表を好みます。初期ユーザーは逆の失敗も報告しています:小さなチケットが非常に大きな diff になった、と。システムプロンプトで「最小限の変更」の指示を明示し、ロールバック用に GPT-5.6 をルーティング可能にしておいてください。コストのルール:272K、キャッシュ、Batch と Flex
ルール 1:入力 272K トークン超で、リクエスト全体が再課金される
入力とキャッシュの単価は 2 倍、出力の単価は 1.5 倍になり、しきい値を超えた分だけでなくリクエスト全体に適用されます。
| リクエスト | 入力コスト | 出力コスト(20K トークン) | 合計 |
|---|---|---|---|
| 入力 272,000 トークン | 272K × $10 = $2.72 | 20K × $50 = $1.00 | $3.72 |
| 入力 280,000 トークン | 280K × $20 = $5.60 | 20K × $75 = $1.50 | $7.10 |
8,000 トークン増えただけで請求額はほぼ倍になります。送信前にトークンを数え、帯域に近づいたらコンテキストを圧縮するか、長文コンテキスト単価が $8 / $30 の GPT-5.6 Sol にリクエストを回してください。
ルール 2:キャッシュは最初の再利用から元が取れる
k 回送る場合:- キャッシュなし:プレフィックス100万トークンあたり
10 × (k + 1)ドル - キャッシュあり:
12.50 + 1 × k
k = 1 で $20 対 $13.50 なので、最初の再利用でキャッシュが勝ち、その後は差が広がります。安定した内容(システムプロンプト、ツールスキーマ、参照ドキュメント)を入力の先頭に置き、30 分の TTL に注意してください。それより長く待機したセッションは書き込みを再度支払います。ルール 3:Batch と Flex は半額
OpenAI では Batch と Flex は Standard の 50% です。オフライン評価、夜間処理、過去データの処理で検討できます。Fast は 2 倍の料金で、Astra のレイテンシ SLA はなく、EU データレジデンシでは利用できません。EvoLink での各モードの対応と課金は未検証です。対象ルートで確認する前に提供元の割引を EvoLink の見積もりに適用しないでください。
ルールを組み合わせる
configuration_update は、対象ルートの対応を検証してから使用してください。| ワークロード | 最も安価で安全な構成 |
|---|---|
| 対話型コーディングエージェント、コンテキスト 50K〜150K | Responses、medium、キャッシュ有効、コンテキストは 272K 未満に維持 |
| 夜間のリポジトリ分析 | Batch、high、272K 未満のチャンク |
| 大量の短い抽出 | Chat Completions、low。品質が許せば GPT-5.6 Terra / Luna |
| リトライを伴う長いリサーチチェーン | Responses、medium から configuration_update で段階的に上げ、Sol へフォールバック |
レート制限とフォールバック
OpenAI は Astra のレート制限を利用ティア別に公開しています。フルコンテキストのリクエスト 1 件が 1 分あたりのトークン予算を超え得るため、この数字は重要です。
| OpenAI ティア | 1 分あたりリクエスト数 | 1 分あたりトークン数 |
|---|---|---|
| Tier 1 | 500 | 500,000 |
| Tier 2 | 5,000 | 1,000,000 |
| Tier 3 | 5,000 | 2,000,000 |
| Tier 4 | 10,000 | 4,000,000 |
| Tier 5 | 15,000 | 40,000,000 |
EvoLink では制限はアカウントごとに設定されます。負荷テストの前にダッシュボードを確認してください。明示的に扱うべき失敗モードは 3 つあります:
- リクエスト形式による 400。
temperature、top_p、effortnone、Chat Completions でのツール指定。リクエストを修正し、リトライしない。 - 429 または 5xx。 バックオフ付きでリトライし、その後同じキーで
gpt-5.6-solにフォールバック。タイムアウト、リトライ、フォールバックのガイドがこのパターンを扱っています。 - OpenAI の安全モニターによるタスク停止。 Astra は非同期のミスアライメント監視下で動作し、発火すると API タスクは停止します。ログを残し、運用者に通知し、ループさせずにフォールバックモデルへタスクを回してください。
def call_with_fallback(**kwargs):
for model in ("gpt-6-astra", "gpt-5.6-sol"):
try:
return client.responses.create(model=model, **kwargs)
except Exception as err: # 本番では 429/5xx に絞る
last = err
raise lastFAQ
GPT-6 にはどのモデル ID を使いますか?
gpt-6-astra です。OpenAI にも EvoLink にも汎用の gpt-6 エイリアスはなく、同じ文字列が Chat Completions と Responses の両方で使えます。Chat Completions で GPT-6 Astra のツールを使えますか?
使えません。OpenAI ではこのモデルのツール呼び出しは Responses のみですが、Chat Completions はテキストと画像の入力を受け付けます。EvoLink 経由の画像入力は対象ルートでの検証が必要です。
どの推論 effort から始めるべきですか?
medium、以前 none または minimal を使っていたタスクは low から始めてください。OpenAI は configuration_update によるタスクごとの引き上げを文書化しています。EvoLink 経由では対象ルートで検証してから使用してください。GPT-6 Astra は temperature を受け付けますか?
temperature、top_p、logprobs は 400 を返します。リクエストから削除してください。入力 272K トークンを超えるリクエストの課金は?
リクエスト全体が長文コンテキスト帯に移ります:入力とキャッシュは 2 倍、出力は 1.5 倍。先にトークンを数え、しきい値に近づいたら圧縮するか分割してください。
GPT-5.6 から移行するときに何が変わりますか?
temperature と top_p を削除し、none を low に置き換え、ツール呼び出しを Responses に移します。OpenAI はキャッシュオプションの変更も文書化しています。EvoLink のエンドポイントとキーは同じですが、移行前にキャッシュオプションと高度な機能を対象ルートで検証してください。GPT-6 Astra は Amazon Bedrock にありますか?
GPT-6 Astra の EvoLink 料金はどこで確認できますか?
出典
- OpenAI:GPT-6 Astra モデルドキュメント
- OpenAI:GPT-6 Astra モデルガイド(移行、非対応パラメータ、ツールは Responses のみ)
- OpenAI:推論ガイド
- OpenAI:プロンプトキャッシュガイド
- OpenAI:Fast モードガイド
- OpenAI:レート制限ガイド
- OpenAI API 料金
- OpenAI:GPT-6 Astra 発表
- AWS:Amazon Bedrock の OpenAI モデルカード
- Shinsuke Kagawa:GPT-5.6 Sol から GPT-6 Astra へ、medium effort から始める


