> ## 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.

# Embeddings

> Call /embeddings with the Ruby SDK.

**Method**: `client.generate_embedding(...)` or `client.create_embedding(...)`.

### Example

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

client = AIStatsSdk::AIStats.new(api_key: ENV.fetch("AI_STATS_API_KEY"))
embedding = client.generate_embedding(
  model: 'openai/text-embedding-3-large',
  input: 'Sample text'
)
```

### Key parameters

* `model` (required): Embedding model id (e.g., `openai/text-embedding-3-large`).
* `input` (required): String or array of strings.
* `encoding_format`: `float` (default) or `base64`.
* `dimensions`: Optional integer to truncate embedding length (model-dependent).
* `user`: Optional end-user tag.

### Returns

Embedding payload (JSON)