API 契約 (NEXT-19)
機 械可読版: contracts/api-contract.json(schema_version 1)。
テストで検証します: pkg/gateway/api_contract_test.go(ゲートウェイ)、
sdks/go/yabanin_test.go(SDK の同等性)。形状の変更は破壊的です。schema_version を上げ、すべての同等性テストを更新してください。
1. エラーエンベロープ
2xx 以外の JSON レスポンスは、厳密に {"error":{message,type,param?,code?}} です。message と type は空ではありません。SSE エラーは同じエンベロープを data イベントとして使い、data: [DONE] で終端します。
2. 成功ボディ / null 許容
chat.completion: id/object/choices(空でない配列)。content は空でない文字列です(null にはなりません)。usage のトークンは数値です。- 不明なコストは null または欠落であり、決して 0 ではありません(0 は、正直に無料またはローカルであるレスポンスを意味します)。ゲートウェイ契約に対して検証されています。UI はこの規則に従います。