ZvenoAI
API Reference

Create Embeddings

POST
/v1/embeddings

Генерирует векторные представления (embeddings) для текста. Совместим с OpenAI Embeddings API — можно использовать любой OpenAI SDK, указав base_url: "https://api.zveno.ai/v1".

Поддерживает:

  • Единичный и batch input (строка или массив строк)
  • Выбор формата (float, base64)
  • Настройки выбора провайдера (provider)

Модель указывается в формате vendor/model (например, openai/text-embedding-3-small).

Аутентификация: Authorization: Bearer <api-key>.

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "http://localhost:8080/v1/embeddings" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "input": null  }'
{
  "id": "string",
  "object": "string",
  "data": [
    {
      "object": "string",
      "embedding": [
        0.1
      ],
      "index": 0
    }
  ],
  "model": "string",
  "usage": {
    "prompt_tokens": 0,
    "total_tokens": 0,
    "cost": 0.1
  }
}

List Model Providers GET

Возвращает список провайдеров для конкретной модели с информацией о ценах, поддерживаемых возможностях (streaming, tool use) и статусе. Путь: `/v1/models/{vendor}/{model}/providers` (например, `/v1/models/anthropic/claude-sonnet-4-20250514/providers`).

List Embedding Models GET

Возвращает список доступных embedding моделей с информацией о размерности, ценах и поддерживаемых возможностях. Авторизация не требуется.