AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
Embeddings

OpenAI Embeddings

创建 OpenAI 兼容的文本向量。

OpenAI Embeddings 接口将单条或批量输入转换为向量表示,可用于语义搜索、聚类、推荐和向量检索。输入限制、输出维度以及可选参数是否生效取决于所选 Embedding 模型。

POST/v1/embeddings

为给定输入创建向量表示,可用于语义搜索、聚类、推荐和其他向量检索场景。接口支持单条文本、批量文本、Token 数组及批量 Token 数组输入。

输入上限和输出维度取决于所选模型。以 text-embedding-ada-002 为例,该模型输出 1536 维向量,最大输入为 8192 个 Token;其他模型可能使用不同限制。

Authorization

bearerAuth
AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

根据输入数量选择文本结构;两个视图使用同一个 Embeddings 端点。

application/json
单条文本

将一个非空字符串转换为一条嵌入向量,适合单条内容测试和实时查询。

model
当前 API Key 可见的 Embedding 模型 ID。
input
需要转换为向量的单个非空字符串。
encoding_format
向量编码格式,默认使用 float。
application/json
{
  "model": "MODEL_ID",
  "input": "这家餐厅的食物很好吃,服务员也很友好。",
  "encoding_format": "float"
}
完整字段参考同时保留文本与 Token 的单条、批量输入结构

Token 数组和批量 Token 数组仍保留在完整字段参考中;输入数量、长度和向量维度以所选模型限制为准。

Response Body

application/json

application/json

application/json

application/json

application/json