
このGPT-6.2 APIガイドでは、APIキーの取得から、cURLとPython OpenAI SDKで gpt-6.2-sol または gpt-6.2-astra へのリクエストを動かすところまでを、ResponsesとChat Completionsの両エンドポイントについて解説します。すべてのリクエストボディは、2026年11月18日時点のPoYoの公開スキーマとOpenAIのGPT-6.2移行ノートに沿っています。プロンプトは先にGPT-6.2 SolのモデルページまたはGPT-6.2 Astraのモデルページで試せます。
モデルについて初めて知る方は、GPT-6.2 APIの概要で上限と位置づけを確認してください。
始める前に
PoYoのダッシュボードでキーを作成し、サーバー側で保管します。
export POYO_API_KEY="your-poyo-key"
| 形式 | エンドポイント | 使う場面 |
|---|---|---|
| Responses | POST https://api.poyo.ai/v1/responses | 新規コード、関数ツール、画像入力、推論エフォート |
| Chat Completions | POST https://api.poyo.ai/v1/chat/completions | 既存のChat Completionsコード、テキストのみのメッセージ、ツールなし |
すべてのリクエストで Authorization: Bearer $POYO_API_KEY を送ります。例では gpt-6.2-sol を使っています。Astraを使う場合は gpt-6.2-astra に置き換えてください。リクエストの構造は同じです。
OpenAIのGPT-6.2ガイドにある3つのルールが、以下のすべての例に当てはまります。
temperatureやtop_pを送らないでください。OpenAIはこれらに加え、Chat Completionsではlogprobsとtop_logprobs、Responsesではtop_logprobsも省略するよう求めています。PoYoのスキーマには、旧モデル向けにtemperatureとtop_pがまだ記載されています。- 推論エフォートを
noneに設定しないでください。APIが拒否します。 - 固定の指示は
inputの先頭にあるdeveloperメッセージに入れてください。GPT-6.2はトップレベルのinstructionsをinputの後ろに追加するため、キャッシュ可能なプレフィックスから外れてしまいます。
cURLでGPT-6.2 APIに最初のリクエストを送る
curl https://api.poyo.ai/v1/responses \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"input": [
{"role": "developer", "content": "You are a code reviewer. Be specific and cite line numbers."},
{"role": "user", "content": "Review this function for race conditions: ..."}
],
"reasoning": {"effort": "medium"},
"max_output_tokens": 8000,
"store": false
}'
model と input は必須です。input はプレーンな文字列、または role(developer、system、user、assistant)と content を持つ項目の配列です。このガイドで使うその他のドキュメント化されたフィールドは、reasoning、max_output_tokens、stream、store、tools、tool_choice、previous_response_id、metadata です。
レスポンスはResponsesオブジェクトがそのまま返されます。テキストは type: "output_text" の output[].content[] ブロックに、呼び出しのステータスは status に、トークン数は usage.input_tokens、usage.output_tokens、usage.total_tokens に入ります。
OpenAI SDKを使ったPython
SDKの接続先をPoYoに向けます。
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.poyo.ai/v1", api_key=os.environ["POYO_API_KEY"])
resp = client.responses.create(
model="gpt-6.2-sol",
input=[
{"role": "developer", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Write a migration plan from Celery 4 to Celery 5."},
],
reasoning={"effort": "medium"},
max_output_tokens=8000,
)
print(resp.output_text)
print(resp.status, resp.usage)
resp.output_text は、すべての output_text ブロックを連結するSDKのヘルパーです。呼び出しのたびに resp.usage をログに記録してください。後述の費用のセクションでこの値を使います。
既存コード向けのChat Completions
すでに chat.completions.create を使っているコードなら、モデルを変更し、サンプリング関連のフィールドを削除します。
resp = client.chat.completions.create(
model="gpt-6.2-sol",
messages=[
{"role": "system", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Explain the CAP theorem with one example per trade-off."},
],
max_tokens=4000,
)
print(resp.choices[0].message.content, resp.choices[0].finish_reason)
同じリクエストをcURLで送る場合:
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"messages": [{"role": "user", "content": "Explain vector databases in one sentence."}],
"max_tokens": 1000
}'
PoYoのChat Completionsスキーマに記載されているのは、model、messages(文字列の content、ロールは system、user、assistant)、max_tokens、stream、stop、n、およびペナルティ関連のフィールドです。tools は記載されておらず、OpenAIもGPT-6.2のツール呼び出しにはResponsesが必要だとしているため、エージェントは /v1/responses で動かすべきです。
GPT-6.2 APIで推論エフォートを設定する
OpenAIはこのフィールドを、Responsesでは reasoning.effort、Chat Completionsでは reasoning_effort と呼んでいます。PoYoのResponsesリファレンスには reasoning(例:{"effort": "medium"})が記載されていますが、Chat Completionsリファレンスにはまだ reasoning_effort が載っていないため、このガイドではResponsesでのみエフォートを設定します。
| 状況 | 設定 | 出典 |
|---|---|---|
| 新規の統合 | medium | OpenAI:「新規の統合では medium から始めてください」 |
以前は none または minimal | low | OpenAIのGPT-6.2移行ノート |
| 長いタスクや複雑なタスク | より高いレベル | OpenAI:高いエフォートは「最後のチェックまでやり抜く助けになり得る」 |
none | 拒否される | OpenAIのモデルページ |
OpenAIの推論ガイドでは、指定可能な値として low、medium、high、xhigh、max が挙げられていますが、モデルによって異なるとされています。GPT-6.2のモデルページには受け付けるレベルの一覧がないため、medium より上のレベルをハードコードする前に、テストリクエストを1回送ってください。推論トークンは出力として課金され、max_output_tokens にも含まれます。OpenAIはこれを usage.output_tokens_details.reasoning_tokens で報告します。
GPT-6.2 APIのレスポンスをストリーミングする
"stream": true を指定すると、PoYoは text/event-stream を返します。各 data: 行はJSONで、その type がイベントの種類を示します。テキストは response.output_text.delta として届き、response.completed が usage を含む最終オブジェクトを運びます。PoYoは別個の event: 行を送らず、ストリームは data: [DONE] で終わります。
stream = client.responses.create(
model="gpt-6.2-sol",
input="Write a 100-word product introduction for a log search tool.",
reasoning={"effort": "low"},
max_output_tokens=2000,
stream=True,
store=False,
)
usage = None
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
usage = event.response.usage
elif event.type == "response.failed":
raise RuntimeError(event.response)
print("\n", usage)
Chat Completionsでは、stream=True で chat.completion.chunk イベントが返ります。テキストは choices[0].delta.content に入り、最後のチャンクに usage が含まれます。
画像入力
GPT-6.2はテキストとともに画像を受け付けます。PoYoでは、公開URLまたは完全なData URI(data:image/png;base64,...)を指定した input_image ブロックとしてResponsesに送ります。PoYoのドキュメントでは、テキストを画像の前に置くことが推奨されています。
{
"model": "gpt-6.2-sol",
"input": [
{
"role": "user",
"content": [
{"type": "input_text", "text": "List every service in this architecture diagram that writes to the database."},
{"type": "input_image", "image_url": "https://example.com/diagram.png"}
]
}
],
"max_output_tokens": 3000
}
使用量を読み取ってリクエストの費用を計算する
PoYoの100万トークンあたりの価格:Solは入力$1.60、出力$8、キャッシュ読み取り$0.08、キャッシュ書き込み$2、Astraは$6.40、$32、$0.32、$8です(1クレジット = $0.005)。
OpenAIのキャッシュガイドによれば、課金対象のキャッシュ読み取りは usage.input_tokens_details.cached_tokens に、書き込みは usage.input_tokens_details.cache_write_tokens に報告されます。PoYoのスキーマには input_tokens_details と output_tokens_details が含まれていますが、そのキーは記載されていないため、防御的に読み取ってください。
PRICES = { # PoYo USD per 1M tokens: input, output, cache read, cache write
"gpt-6.2-sol": (1.60, 8.00, 0.08, 2.00),
"gpt-6.2-astra": (6.40, 32.00, 0.32, 8.00),
}
def estimate_cost_usd(model: str, usage) -> float:
p_in, p_out, p_read, p_write = PRICES[model]
details = getattr(usage, "input_tokens_details", None)
cached = getattr(details, "cached_tokens", 0) or 0
written = getattr(details, "cache_write_tokens", 0) or 0
fresh = usage.input_tokens - cached - written
return (fresh * p_in + cached * p_read + written * p_write
+ usage.output_tokens * p_out) / 1_000_000
これは見積もりとして扱い、PoYoの使用量ログと突き合わせてください。ここに挙げた価格はすべて短コンテキストの料金です。OpenAIは入力が272Kトークンを超えると高い料金を課すため、そこまで大きなリクエストについてはモデルページを確認してください。計算例はGPT-6.2 APIの料金にまとめています。
対処しておきたいエラー
| HTTP | 原因 | 対処 |
|---|---|---|
| 400 | 無効なフィールド(validation_error、詳細付き) | ボディを修正する。none のエフォートやドキュメントにないフィールドでここに該当することがある |
| 401 | APIキーがない、または無効 | Authorization ヘッダーを確認する |
| 402 | クレジット不足 | チャージしてから再試行する |
| 404 | 不明なモデル(model_not_found) | IDを確認する:gpt-6.2-sol、gpt-6.2-astra |
| 429 | レート制限 | 待ってから再試行する |
| 500 / 502 / 503 | サーバーまたは上流のエラー | 指数バックオフで再試行する |
PoYoのドキュメントによれば、LLMエンドポイントには現在レート制限がありませんが、それでも 429 は処理しておいてください。OpenAI SDKでは openai.APIStatusError を捕捉し、status_code で分岐します。再試行するのは5xxと 429 だけにしてください。400はボディを変えない限り何度送っても失敗します。レスポンスボディの全体はPoYoのエラーコードを参照してください。
本番投入前のチェックリスト
POYO_API_KEYはサーバー側に置き、ブラウザやモバイルのコードには決して含めない。- 共通のヘルパー関数も含め、GPT-6.2へのすべてのリクエスト経路から
temperatureとtop_pを取り除く。 - 必ず
max_output_tokens(またはmax_tokens)を設定し、その上限の中に推論トークンの余地を残す。 status/finish_reasonとusageブロック全体を自分のリクエストIDと一緒にログに記録し、途中で切れた回答や費用の急増が見えるようにする。- 長く固定的なコンテキストは最初の
developerメッセージに、変化する質問は最後に置き、プロンプトキャッシュが効く余地をつくる。 - モデルIDは設定ファイルで固定し、デプロイなしで
gpt-6.2-solとgpt-6.2-astraを切り替えられるようにする。
ツール、ツール呼び出しのストリーミング、長いエージェントセッションでのキャッシュについては、コーディングエージェント向けGPT-6.2 APIに進んでください。
よくある質問
PythonでGPT-6.2 APIを呼び出すには?
OpenAI SDKを base_url="https://api.poyo.ai/v1" とPoYoのキーで設定し、client.responses.create で model="gpt-6.2-sol" または "gpt-6.2-astra" を指定します。
GPT-6.2 APIはストリーミングに対応していますか?
はい、両方のエンドポイントで対応しています。stream: true を設定すると、Responsesは response.output_text.delta のような型付きイベントを、Chat Completionsは chat.completion.chunk イベントを送ります。どちらも data: [DONE] で終わります。
GPT-6.2 APIの推論エフォートを設定するには?
/v1/responses で "reasoning": {"effort": "medium"} を送ります。OpenAIは最初は medium を推奨しており、none は拒否されます。
GPT-6.2 APIのリクエストがtemperatureで失敗するのはなぜですか?
OpenAIは、GPT-6.2では temperature と top_p を省略するよう求めています。これらを削除し、出力の長さは max_output_tokens または max_tokens で制御してください。
GPT-6.2 APIに画像を送るには?
/v1/responses を使い、input_text ブロックの後に input_image ブロック(URLまたはData URI)を置きます。PoYoのChat Completionsスキーマに記載されているのは文字列のcontentのみです。