---
title: "Embeddings API（OpenAI 互換）"
description: "OpenAI-compatible /v1/embeddings。request fields、batch inputs、dimensions。"
source: https://lazu.ai/docs/ja/endpoints/embeddings
updated: 2026-10-02
---

# Embeddings

**POST** `/v1/embeddings`

OpenAI-compatible clients で vector embeddings を作成します。モデルカタログで embeddings support と custom dimensions support を確認してください。

## リクエスト例

```bash
curl https://api.lazu.ai/v1/embeddings \
  -H "Authorization: Bearer $LAZU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["doc one", "doc two"]
  }'
```

## レスポンス例

```json
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0021, -0.013] }
  ],
  "model": "text-embedding-3-small",
  "usage": { "prompt_tokens": 6, "total_tokens": 6 }
}
```

## Request body

- `model` `string` (必須) — `/api/models/catalog` の embedding model ID。
- `input` `string | string[]` (必須) — text input または ordered batch。response は入力順を保持します。
- `dimensions` `integer` (任意) — truncation を support する model の optional vector dimension。
- `encoding_format` `string` (任意) — upstream が support する場合の output encoding format。 指定可能な値: `float`, `base64`

## Response

- `object` `string` — 通常は `list`。
- `data` `object[]` — input ごとの embedding item。
- `data[].embedding` `number[] | string` — vector values または `encoding_format` に応じた base64 vector。
- `usage.prompt_tokens` `integer` — embedding に使われた input tokens。

## Batch guidance

小さな batch は array で渡せます。大規模 jobs では client-side chunking を行い、
provider の body-size と token limits を超えないようにしてください。