跳轉到主要內容
POST
/
v1
/
embeddings
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key="<COMETAPI_KEY>",
)

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="The food was delicious and the waiter was friendly.",
)

print(response.data[0].embedding[:5])  # First 5 dimensions
print(f"Dimensions: {len(response.data[0].embedding)}")
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        -0.0021,
        -0.0491,
        0.0209,
        0.0314,
        -0.0453
      ]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 2,
    "total_tokens": 2
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI 透過單一端點支援來自多個供應商的嵌入模型。傳入一個或多個文字字串，即可取得用於語意搜尋、分群、分類或檢索增強生成（RAG）的數值向量。可用的嵌入模型與定價請參閱模型清單。
text-embedding-3-* 模型支援 dimensions 參數，可在不明顯降低準確度的情況下縮短嵌入向量。這有助於降低儲存成本，同時保留大部分語意資訊。
若要在單一請求中嵌入多段文字，請將字串陣列傳入 input 參數。批次輸入比逐一發送個別請求要高效許多。

授權

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

主體

application/json
​
model
string
必填

The embedding model to use. See the Models page for current embedding model IDs.

範例:

"text-embedding-3-small"

​
input
必填

The text to embed. Can be a single string, an array of strings, or an array of token arrays. Each input must not exceed the model's maximum token limit (8,191 tokens for text-embedding-3-* models).

​
encoding_format
enum<string>
預設值:float

The format of the returned embedding vectors. float returns an array of floating-point numbers. base64 returns a base64-encoded string representation, which can reduce response size for large batches.

可用選項:
float,
base64
​
dimensions
integer

The number of dimensions for the output embedding vector. Only supported by text-embedding-3-* models. Reducing dimensions can lower storage costs while maintaining most of the embedding's utility.

必填範圍: x >= 1
​
user
string

A unique identifier for your end-user, which can help monitor and detect abuse.

回應

200 - application/json

A list of embedding vectors for the input text(s).

​
object
enum<string>

The object type, always list.

可用選項:
list
範例:

"list"

​
data
object[]

An array of embedding objects, one per input text. When multiple inputs are provided, results are returned in the same order as the input.

​
model
string

The model used to generate the embeddings.

範例:

"text-embedding-3-small"

​
usage
object

Token usage statistics for this request.