Jina Embeddings v3
最近更新:2026年11月22日
Jina AI 嵌入模型 Jina Embeddings v3(jina/jina-embeddings-v3)的规格参数、维度截断与调用示例。
Jina Embeddings v3 是广泛应用的多语言文本嵌入模型(570M 参数),覆盖 89 种语言、8K 上下文、1024 默认维度(Matryoshka 可截断至 32 维),内置 5 种任务专用 LoRA 适配器并原生支持 late_chunking。
该模型通过 Create Embeddings(POST /v1/embeddings)端点调用,支持通过 Authorization: Bearer <key> 鉴权。
模型规格
| 属性 | 说明 |
|---|---|
| 模型 ID | jina/jina-embeddings-v3 |
| 可用别名 | jina-embeddings-v3 |
| 上下文上限 | 8,192 token(8K) |
| 输出维度 | 默认 1024 维(API 支持 1–1024,Matryoshka 推荐 32–1024 维) |
| 支持输入 | 仅文本(兼容 OpenAI SDK 字符串、{ text } 对象与数组) |
| 支持任务适配器 | retrieval.query、retrieval.passage、text-matching、classification、separation |
| 计费方式 | 仅按总输入 token(usage.total_tokens)计费,无输出 token 费用;实时单价见模型详情页 |
| 流式输出 | 不支持 |
https://gateway.amux.ai/v1/embeddings鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"固定为 application/json。
请求
application/jsonmodelstring必填模型标识,支持规范 ID jina/jina-embeddings-v3 或裸名别名 jina-embeddings-v3。
inputstring | object | array<string | object>必填待嵌入的文本字符串、{ text } 对象或由其组成的数组(单条上限 8K token)。
›inputstring | object | array<string | object>
#1string#2object›#2object
textstring待嵌入的文本内容。
#3array<string | object>›#3array<string | object>
#1string#2object›#2object
textstring待嵌入的文本片段。
task"retrieval.query" | "retrieval.passage" | "text-matching" | "classification" | "separation"任务适配器优化方向:retrieval.query(检索查询)、retrieval.passage(检索文档)、text-matching(语义匹配)、classification(分类)或 separation(聚类)。
dimensionsinteger默认 1024输出向量维度(API 支持 1–1024,Matryoshka 推荐截断范围 32–1024,默认 1024)。
embedding_type"float" | "base64" | "binary" | "ubinary" | array<"float" | "base64" | "binary" | "ubinary">输出编码格式:float、base64、binary、ubinary,或由其组成的数组。
normalizedboolean默认 true是否对输出向量执行 L2 归一化(默认 true)。
truncateboolean默认 false输入超过 8K 上下文上限时是否自动尾部截断而非报错(默认 false)。
late_chunkingboolean默认 false是否对同批次输入的多个文本块启用 Late Chunking,在切分池化前拼接为单序列共享长文档上下文(仅对文本输入生效)。
响应
200response向量生成成功。
400response请求参数不合法或输入超过上下文上限。
402response工作区可用余额不足。
使用说明
面向已有 jina-embeddings-v3 向量索引的存量系统提供零改动兼容(聚类任务值为 separation);新建索引建议优先评估 Jina Embeddings v5 Text Small(32K 上下文)。
错误处理
错误响应采用 OpenAI 标准结构({ "error": { "type", "message", … } })。输入超长或字段校验失败返回 400 invalid_request;单次请求体超过 32 MB 直接拒绝且不触发跨渠道重试。完整错误码见错误与重试。
curl https://gateway.amux.ai/v1/embeddings \
-H "Authorization: Bearer $AMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jina/jina-embeddings-v3",
"task": "retrieval.passage",
"input": [
"Organic skincare for sensitive skin with aloe vera and chamomile."
]
}'{
"object": "list",
"model": "jina/jina-embeddings-v3",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [
0.0123,
-0.0456,
0.0789
]
}
],
"usage": {
"prompt_tokens": 14,
"total_tokens": 14
}
}