Responses API

/v1/responses は OpenAI のネイティブ主要エンドポイントの一つです。公式では、新規プロジェクトでは Responses の評価を優先することを推奨しています。クライアントやフレームワークがデフォルトで Chat Completions を使用している場合は、OpenAI 互換呼び出し。

Base URL は引き続き https://api.rokoapi.com/v1。

エンドポイント

POST /v1/responses

クイックスタート

curl https://api.rokoapi.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "自己紹介を一文で書いてください",
    "instructions": "簡潔に回答するアシスタントです"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="自己紹介を一文で書いてください",
    instructions="簡潔に回答するアシスタントです",
)
print(response.output_text)

テキストの取得には、SDK の output_textを手動で反復処理する場合は、 output の最初の項目が reasoning ではなく message。

よく使うパラメータ

モデル機能ラベル

モデルページには、管理画面で設定された Responses 機能が表示されます。リクエスト前に次のラベルを確認してください。

表示されていない機能をクライアント側で利用可能とみなさないでください。変換互換モデルでは、会話状態、応答保存、圧縮など、アップストリームのリソースライフサイクルに依存する機能は宣言されません。

現在の変換互換モデル

これらはステートレスな互換変換です。会話とツール呼び出しの完全な履歴をクライアント側で保持し、次の input に再送してください。previous_response_id、conversation、compact、応答保存には対応していません。

マルチターン対話

デフォルトではクライアント側で履歴を管理し、完全なコンテキストを input 配列に格納してください。モデルページに previous-response-id または conversation-state が明示されている場合にのみ、対応するステートフルパラメータを使用してください。

ストリーミング出力

Responses のストリーミングは意味のあるイベント（例： response.output_text.delta）であり、Chat Completions の choices[0].delta とは異なります。 stream: true を設定した後、イベントタイプに応じて処理してください。

Chat Completions との比較

注意事項

• まず モデルページ または公開済みモデルのドキュメントで、対象モデルが Responses に対応しているかを確認してください。
• 組み込みツールやバックグラウンドタスクなどの機能はアップストリームに依存します。モデルページで宣言されていない機能は互換性保証の対象外です。

関連リンク

• OpenAI 互換呼び出し
• ストリーミングリクエスト
• SDK 例