Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content
エンドポイント / OpenAI-compatible

Responses API

POST/v1/responses

Responses は reasoning models、multimodal input、Lazu file_id dereferencing に適しています。uploaded files や新しい OpenAI response features が必要な場合に推奨します。

使い分け

Responses を使う

uploaded files、reasoning controls、document workflows、server-side normalized multimodal inputs。

Chat completions を使う

simple chat、SDK compatibility、tool calling、既存の /v1/chat/completions ベースのアプリ。

Request body

modelstring
required

/api/models/catalog の model ID。 supported_endpoint_typesに responses を含む model を優先してください。

inputstring | object[]
required

text input または response input messages array。

instructionsstring
nullable

response の system-level instructions。

reasoningobject
nullable

supported models で reasoning effort を制御します。例： {"effort":"medium"}。

toolsobject[]
nullable

OpenAI-compatible Responses shape の tool definitions。

streamboolean
nullable

model が対応する場合、response events stream を返します。

max_output_tokensinteger
nullable

generated output tokens の上限。

File dereferencing

Files で upload した file_id を参照できます。 dereference が発生した場合、Lazu は X-Lazu-File-Dereference: 1 を付けます。

制限：

  • single file purpose limit は引き続き適用されます。
  • 1 回の Responses call で dereference される files は合計 64 MB 未満。
  • Chat completions は file_id を自動 dereference しません。

Response

idstring

Response ID。

outputobject[]

output messages、reasoning items、tool calls、その他 response events。

usage.input_tokensinteger
nullable

upstream が usage を返す場合の input token count。

usage.output_tokensinteger
nullable

upstream が usage を返す場合の output token count。

完全な照合には同じ API Key で

GET /api/usage/requests/{request_id} を使ってください。