how-tos

GPT-6.2 APIガイド:cURLとPythonで最初のリクエスト、ResponsesとChat Completions

Poyo.ai Team
4 min read
Share:

GPT-6.2 APIガイド:cURLとPythonで最初のリクエストを送る

この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"
形式エンドポイント使う場面
ResponsesPOST https://api.poyo.ai/v1/responses新規コード、関数ツール、画像入力、推論エフォート
Chat CompletionsPOST 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つのルールが、以下のすべての例に当てはまります。

  1. temperature や top_p を送らないでください。OpenAIはこれらに加え、Chat Completionsでは logprobs と top_logprobs、Responsesでは top_logprobs も省略するよう求めています。PoYoのスキーマには、旧モデル向けに temperature と top_p がまだ記載されています。
  2. 推論エフォートを none に設定しないでください。APIが拒否します。
  3. 固定の指示は 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でのみエフォートを設定します。

状況設定出典
新規の統合mediumOpenAI:「新規の統合では medium から始めてください」
以前は none または minimallowOpenAIの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 のエフォートやドキュメントにないフィールドでここに該当することがある
401APIキーがない、または無効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のみです。

Share: