AI 模型接口文本
文本向量(同步)
POST
/api/v1/embeddingsHeader 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
Default
1024Value in
2048 | 1536 | 1024 | 768 | 512 | 256 | 128 | 64encoding_format?string
控制返回的 Embedding 格式。
float:浮点数格式(默认)
base64:Base64 编码格式
Default
"float"Value in
"float" | "base64"return_original?boolean
返回原厂数据。默认 false:返回中继站标准响应格式(code+data+message+request_id);true:返回原厂格式。
Default
falseResponse 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"
}