Embeddings

Преобразование текста в векторные представления для семантического поиска, кластеризации, классификации и других задач.

Эндпоинт


POST https://api.ofox.io/v1/embeddings

Параметры запроса

Параметр	Тип	Обязателен	Описание
`model`	string	✅	Модель эмбеддингов, например `openai/text-embedding-3-small`
`input`	string \| string[]	✅	Текст для преобразования (одиночный или пакетный)
`encoding_format`	string	—	Формат вывода: `float` (по умолчанию) или `base64`
`dimensions`	number	—	Размерность выходного вектора (поддерживается не всеми моделями)

Примеры запросов

cURL

Terminal


curl https://api.ofox.io/v1/embeddings \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "OfoxAI is an LLM Gateway"
  }'

Python

embedding.py


from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.ofox.io/v1",
    api_key="<Ваш OFOXAI_API_KEY>"
)
 
response = client.embeddings.create(
    model="openai/text-embedding-3-small",
    input="OfoxAI is an LLM Gateway"
)
 
embedding = response.data[0].embedding
print(f"Размерность вектора: {len(embedding)}")

TypeScript

embedding.ts


import OpenAI from 'openai'
 
const client = new OpenAI({
  baseURL: 'https://api.ofox.io/v1',
  apiKey: '<Ваш OFOXAI_API_KEY>'
})
 
const response = await client.embeddings.create({
  model: 'openai/text-embedding-3-small',
  input: 'OfoxAI is an LLM Gateway'
})
 
console.log(`Размерность вектора: ${response.data[0].embedding.length}`)

Формат ответа


{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0091, 0.0156, ...]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}

Доступные модели

Модель	Размерность	Описание
`openai/text-embedding-3-small`	1536	Оптимальное соотношение цена/качество
`openai/text-embedding-3-large`	3072	Максимальная точность
`qwen/text-embedding-v4`	1024	Оптимизировано для китайского языка, модель эмбеддингов Tongyi Qianwen