Embeddings

POST /v1/embeddings

POSThttps://api.topbilling.in/v1/embeddingsscope chat:write

Creates embedding vectors for one or more texts. OpenAI Embeddings request and response shapes.

Authentication

Send your key as Authorization: Bearer tb_… or x-api-key: tb_…. See Authentication.

Parameters

modelstringrequired

A model whose capabilities include embeddings.

inputstring | string[]required

Text to embed. Must not be empty; pre-tokenised arrays are rejected.

encoding_formatstring

float (default) or base64.

dimensionsinteger

Positive integer, passed to the model.

userstring

Your end-user identifier.

Any other field is ignored and counted in the tb-dropped-hints response header.

Request

POST /v1/embeddings

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["TB_API_KEY"], base_url="https://api.topbilling.in/v1")

result = client.embeddings.create(
    model="<embedding-model-id>",
    input=["Refund policy for annual plans", "How do I rotate an API key?"],
)
print(len(result.data), len(result.data[0].embedding))

Response

json

{
  "object": "list",
  "data": [{"object": "embedding", "index": 0, "embedding": [0.0123, -0.0456, ...]}],
  "model": "<embedding-model-id>",
  "usage": {"prompt_tokens": 12, "total_tokens": 12}
}

Errors

400 for a missing model or invalid input, encoding_format or dimensions; otherwise as in Errors.