Amux AI

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> 鉴权。

模型规格

属性说明
模型 IDjina/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 费用;实时单价见模型详情页
流式输出不支持
POSThttps://gateway.amux.ai/v1/embeddings

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。

Content-Typestring必填默认 "application/json"

固定为 application/json。

请求

application/json
modelstring必填

模型标识,支持规范 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
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
  }
}