tokenhop-embeddings

Files (1)

• SKILL.md

SKILL.md (first lines)

# tokenhop — Embeddings

Requires `TOKENHOP_URL` (and `TOKENHOP_KEY` if auth enabled). See <https://raw.githubusercontent.com/tokenhop/tokenhop/refs/heads/master/skills/tokenhop/SKILL.md> for setup.

If they are unset, use the legacy `NINEROUTER_URL` / `NINEROUTER_KEY` instead. <!-- legacy(9router): remove in v2 -->

## Discover

```bash
curl $TOKENHOP_URL/v1/models/embedding | jq '.data[].id'
# Per-model dimensions
curl "$TOKENHOP_URL/v1/models/info?id=openai/text-embedding-3-small"
```

## Endpoint

`POST $TOKENHOP_URL/v1/embeddings`

| Field             | Required | Notes                        |
| ----------------- | -------- | ---------------------------- |
| `model`           | yes      | from `/v1/models/embedding`  |
| `input`           | yes      | string OR array of strings   |
| `encoding_format` | no       | `float` (default) / `base64` |
| `dimensions`      | no       | OpenAI v3 only               |

## Examples

```bash
curl -X POST $TOKENHOP_URL/v1/embeddings \
  -H "Authorization: Bearer $TOKENHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/text-embedding-3-small","input":["hello","world"]}'
```

JS:

```js
const r = await fetch(`${process.env.TOKENHOP_URL}/v1/embeddings`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TOKENHOP_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "gemini/text-embedding-004", input: "RAG chunk text" }),
});
const { data } = await r.json();
console.log(data[0].embedding.length); // dimension
```

## Response shape

```json
{ "object": "list", "model": "openai/text-embedding-3-small",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0123, -0.045, ...] },
    { "object": "embedding", "index": 1, "embedding": [...] }
  ],
  "usage": { "prompt_tokens": 5, "total_tokens": 5 } }
```

## Provider quirks

| Provider                                                                                                         | Notes                                                                             |
| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `openai`, `openrouter`, `mistral`, `voyage-ai`, `fireworks`, `together`, `nebius`, `github`, `nvidia`, `jina-ai` | Native OpenAI shape — `dimensions` works only on OpenAI v3 (`text-embedding-3-*`) |
| `gemini`, `google_ai_studio`                                                                                     | Server auto-converts to `embedContent`/`batchEmbedContents` — send OpenAI shape   |
| `openai-compatible-*`, `custom-embedding-*`                                                                      | Custom `baseUrl` from credentials                                                 |

Batch (`input` as array) is faster; some providers cap batch size.

From tokenhop/tokenhop, MIT.

More from tokenhop/tokenhop