エンドポイント

Responses

POST /responses で OpenAI Responses API 形式のリクエストを送る方法です。公式 SDK の client.responses.create がそのまま動作し、Chat Completions と同じモデルを使えます。リクエスト、レスポンス、エラーを説明します。

プレイグラウンドで試す

Responses エンドポイントは OpenAI Responses API の形式を受け付けるため、公式 SDK の client.responses.create(...) が変更なしで動作します。Chat Completions と同じモデルで実行されます。api14 はボディを変更せずに上流へ転送し、返ってきた usage に基づいて課金します。

POST https://api14.com/api/v1/responses
Authorization: Bearer sk-api14-...
Content-Type: application/json

リクエスト

パラメーター	型	説明
`model`	string, 必須	モデル ID。例: `openai/gpt-5-mini`。
`input`	string \| array, 必須	プロンプトの文字列、または入力項目の配列(`{ role, content }` のメッセージ、`function_call_output` など)。
`instructions`	string	システムレベルの指示。
`stream`	boolean	セマンティックイベント(`response.output_text.delta`、`response.completed` など)を SSE でストリーミングします。
`max_output_tokens`	integer	生成するトークン数の上限。
`temperature`, `top_p`	number	サンプリング制御。
`tools`, `tool_choice`, `parallel_tool_calls`		関数ツール。Web 検索も、ツールとして、または `plugins` から利用できます。
`text`	object	出力形式。例: `{ "format": { "type": "json_schema", "name": "...", "schema": {...} } }`。
`reasoning`	object	`{ "effort": "low" \| "medium" \| "high" }`。推論を参照してください。
`provider`, `models`, `plugins`		Chat Completions と同じゲートウェイ拡張。

ゲートウェイは会話を保存しないため、呼び出しのたびに input で完全なコンテキストを渡してください。previous_response_id のようなステートフルなオプションには対応していない場合があります。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

上の例は Chat Completions を使っています。Node SDK での Responses の同等のコードは次のとおりです。

const response = await client.responses.create({
  model: "openai/gpt-5-mini",
  input: "Write a haiku about APIs.",
});
console.log(response.output_text);

レスポンス

{
  "id": "resp-1760000000-abc123",
  "object": "response",
  "created_at": 1760000000,
  "model": "openai/gpt-5-mini",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "Requests in flight,\nJSON answers drifting back,\none key opens all." }]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 22,
    "total_tokens": 36,
    "input_tokens_details": { "cached_tokens": 0 },
    "output_tokens_details": { "reasoning_tokens": 0 },
    "cost": 0.0000475
  }
}

ゲートウェイは、最終オブジェクト(ストリーミング時は response.completed イベント)から usage を読み取り、cost を USD で残高から差し引きます。

エラー

Chat Completions と同じです: 400 model_required、400 invalid_json、401 invalid_api_key、402 insufficient_balance、403 model_not_allowed / plan_required、404 model_not_found、413 payload_too_large、429 rate_limited / daily_limit_reached、502 upstream_unavailable。エラーを参照してください。