#Responses API

OpenAI のレスポンス項目形式を使用するアプリケーションやコーディングツールには、Responses API を使用します。

POST https://getrouter.ai/v1/responses

#基本リクエスト

curl https://getrouter.ai/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "instructions": "短い段落で回答してください。",
    "input": "リバースプロキシの役割を説明してください。"
  }'

レスポンスには、レスポンス項目を格納した output 配列が含まれます。SDK によっては、集約されたテキストを取得するための output_text プロパティが用意されています。

#Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.responses.create(
    model="MODEL_ID",
    instructions="短い段落で回答してください。",
    input="リバースプロキシの役割を説明してください。",
)

print(response.output_text)

#Node.js / TypeScript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.responses.create({
  model: 'MODEL_ID',
  instructions: '短い段落で回答してください。',
  input: 'リバースプロキシの役割を説明してください。',
})

console.log(response.output_text)

#主なリクエストフィールド

#レスポンスを継続する

レスポンスの継続に対応するワークフローでは、以前のレスポンス ID を渡します。

{
  "model": "MODEL_ID",
  "previous_response_id": "RESPONSE_ID",
  "input": "具体的な例を挙げてください。"
}

ステートフルな継続への対応は、選択したモデルやアップストリームサービスによって異なる場合があります。

#コンテキストを圧縮する

GetRouter は Responses の圧縮エンドポイントを公開しています。

POST https://getrouter.ai/v1/responses/compact

model と、input、instructions、previous_response_id のいずれかを受け取ります。クライアントが Responses の圧縮ワークフローを実装している場合にのみ使用してください。

curl https://getrouter.ai/v1/responses/compact \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "CONVERSATION_INPUT"
  }'

#ストリーミング

stream を true に設定すると、Responses API イベントを受信できます。これは Chat Completions のチャンクとは異なります。ストリーミングを参照してください。

#互換性に関する注意

• Responses エンドポイントに対応するモデルを使用してください。
• Chat Completions で動作するモデルが Responses にも対応するとは限りません。
• Codex などのツールは Responses 固有のイベント形式やツール形式に依存する場合があるため、専用の連携ガイドに従って設定してください。

#次のステップ

• ストリーミング
• Chat Completions
• モデルを選ぶ
• API リファレンス