典名词元典名词元首页
API 文档三方工具教程
AI 模型接口文本

文本向量(同步)

POST/api/v1/embeddings

Header Parameters

Authorization*string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model*string

模型名称。固定值:text-embedding-v4

Value in"text-embedding-v4"
input*string|array<string>

输入待处理的文本。

字符串:最长支持 8,192 Token。

字符串列表:最多支持 10 条,每条最长支持 8,192 Token。

dimensions?integer

指定的向量维度,默认 1024。

可选值:2048、1536、1024(默认)、768、512、256、128、64

Default1024
Value in2048 | 1536 | 1024 | 768 | 512 | 256 | 128 | 64
encoding_format?string

控制返回的 Embedding 格式。

float:浮点数格式(默认)

base64:Base64 编码格式

Default"float"
Value in"float" | "base64"
return_original?boolean

返回原厂数据。默认 false:返回中继站标准响应格式(code+data+message+request_id);true:返回原厂格式。

Defaultfalse

Response Body

application/json

成功

TypeScript Definitions

Use the response body type in TypeScript.

code?integer

状态码

data?object

响应数据

object?string

数据类型,固定为 list

model?string

模型名称

data?array<object>

Embedding 结果数组

[]?object
embedding?array<number>

Embedding 向量

[]?number
index?integer

对应输入文本的索引

object?string

对象类型,固定为 embedding

usage?object
total_tokens?integer

本次请求消耗的 Token 总数

id?string

请求唯一标识

message?string

提示信息

request_id?string

请求ID

curl -X POST "https://api.aa.com.cn/api/v1/embeddings" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "model": "text-embedding-v4",    "input": "string",    "dimensions": 2048,    "encoding_format": "float",    "return_original": false  }'
{
  "code": 0,
  "data": {
    "object": "string",
    "model": "string",
    "data": [
      {
        "embedding": [
          0
        ],
        "index": 0,
        "object": "string"
      }
    ],
    "usage": {
      "total_tokens": 0
    },
    "id": "string"
  },
  "message": "string",
  "request_id": "string"
}