Wire protocol - AI Reserve Developer Documentation

The official inference SDKs translate their Bedrock-shaped interface onto one OpenAI-compatible HTTP endpoint. If you prefer to integrate directly—or want to audit exactly what inference traffic looks like—the endpoint is:

POST https://api.aireserve.com/v1/chat/completions
Authorization: Bearer aireserve_api_…
Content-Type: application/json

The body is OpenAI chat-completions compatible; streaming responses are standard server-sent events terminated by data: [DONE], with a final usage chunk always included. The SDKs translate between this wire format and the Bedrock Converse shapes:

You write (Bedrock shape)	The SDK sends (OpenAI wire)
`modelId`, `inferenceConfig.maxTokens`	`model`, `max_tokens`
`system` blocks	A single leading `system` message
`toolConfig.tools[].toolSpec`	`tools[].function` with JSON Schema parameters
`toolResult` blocks	`role: "tool"` messages keyed by `tool_call_id`
`image` blocks (bytes or URL)	`image_url` content parts (bytes become base64 data URLs)
Stream events (`messageStart` … `metadata`)	Translated from OpenAI SSE chunks by a per-block state machine

The full normative chat mapping—every field, edge case, SSE state transition, and error code—lives in the cross-language specification (SPEC.md) that all five inference SDKs are tested against. GPU infrastructure is a separate REST surface under /v1/gpu/*. Start with the GPU Infrastructure overview for the task-oriented flow, then use the generated endpoint pages for exact request and response schemas.

Endpoints & playground

Every public route is documented under Endpoints in the sidebar, generated from the gateway’s OpenAPI specification — each page includes an interactive playground that sends real requests to https://api.aireserve.com with your own API key (paste it into the Authorization field; get one here). The spec is exported straight from the gateway service’s route schemas:

bun run apps/docs/scripts/export-openapi.ts

​Endpoints & playground

Endpoints & playground