> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-stats.phaseo.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Responses

> Call the Responses API with the Ruby SDK.

**Methods**: `client.generate_response(...)`, `client.create_response(...)`.

### Example

```ruby theme={null}
require 'ai_stats_sdk'

client = AIStatsSdk::AIStats.new(api_key: ENV.fetch("AI_STATS_API_KEY"))

resp = client.create_response(
  "model" => "openai/gpt-4.1",
  "input" => [{ "role" => "user", "content" => [{ "type" => "output_text", "text" => "Summarise this text" }] }],
  "temperature" => 0.7
)
```

### Key parameters

* `model` (required): Target model id.
* `input` (required): Ordered array of input items (messages, tool calls, etc.).
* `temperature` (0–2): Higher = more random.
* `top_p` (0–1) / `top_k` (>=1): Nucleus / k-best sampling controls.
* `max_output_tokens` (int): Hard cap on tokens generated per response; `max_output_tokens_per_message` to cap each message item.
* Tools: `tools` (definitions), `tool_choice` (auto/none/specific), `max_tool_calls` (int), `parallel_tool_calls` (bool).
* Logprobs: `logprobs` (bool), `top_logprobs` (0–20) to return per-token logprobs.
* Output: `response_format` (json/text), `service_tier`, `store` (bool), `stream` (bool).
* Metadata: `metadata` (object) for passthrough, `reasoning` (object) for effort hints.
* Gateway extras: `usage` (bool to request usage), `meta` (bool to include meta block).

### Returns

`ResponsesResponse`