curl --request POST \
--url https://api.aihubmax.com/v1beta/models/{model}:embedContent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": {
"parts": [
{
"text": "什么是深度学习？"
}
]
}
}
'{
"embedding": {
"values": [
0.0123,
-0.0456,
0.0789,
0.0234,
-0.0567
]
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "API密钥无效",
"type": "authentication_error"
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "访问被拒绝",
"type": "permission_error"
}
}{
"error": {
"message": "请求频率超限",
"type": "rate_limit_error"
}
}{
"error": {
"message": "服务器内部错误",
"type": "server_error"
}
}Gemini 格式
Gemini 格式 - 嵌入
- 适用于所有兼容 Gemini 原生格式的嵌入 API
- 将文本转换为高维向量表示
- 支持多种任务类型：检索、分类、聚类、语义相似度等
- 支持自定义输出维度（降维）
POST
/
v1beta
/
models
/
{model}
:embedContent
curl --request POST \
--url https://api.aihubmax.com/v1beta/models/{model}:embedContent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": {
"parts": [
{
"text": "什么是深度学习？"
}
]
}
}
'{
"embedding": {
"values": [
0.0123,
-0.0456,
0.0789,
0.0234,
-0.0567
]
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "API密钥无效",
"type": "authentication_error"
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "访问被拒绝",
"type": "permission_error"
}
}{
"error": {
"message": "请求频率超限",
"type": "rate_limit_error"
}
}{
"error": {
"message": "服务器内部错误",
"type": "server_error"
}
}授权
所有接口均需要使用Bearer Token进行认证
使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY
路径参数
嵌入模型名称，如 gemini-embedding-2-preview
示例:
"gemini-embedding-2-preview"
请求体
application/json
要嵌入的内容
Show child attributes
Show child attributes
嵌入任务类型，影响嵌入向量的优化方向。注意：gemini-embedding-2-preview 不支持此字段，该模型改用 prompt prefix 方式指定任务类型（如 task: search result | query: {content}）
可用选项:
RETRIEVAL_QUERY, RETRIEVAL_DOCUMENT, SEMANTIC_SIMILARITY, CLASSIFICATION, CLUSTERING, QUESTION_ANSWERING, FACT_VERIFICATION, CODE_RETRIEVAL_QUERY 文档标题，仅在 taskType 为 RETRIEVAL_DOCUMENT 时有效
输出向量的维度，用于降维输出。默认 3072
响应
嵌入响应
嵌入结果
Show child attributes
Show child attributes