Amux AI

Jina Embeddings v5 Text Nano

最近更新:2026年11月22日

Jina AI 嵌入模型 Jina Embeddings v5 Text Nano(jina/jina-embeddings-v5-text-nano)的规格参数、维度截断与调用示例。

Jina Embeddings v5 Text Nano 是基于 EuroBERT-210M 的第五代轻量多语言文本嵌入模型(239M 参数),支持 8K 上下文、768 默认维度(Matryoshka 可截断至 32 维)及任务适配器,并与 jina-embeddings-v5-omni-nano 共享同一向量空间。

该模型通过 Create Embeddings(POST /v1/embeddings)端点调用,支持通过 Authorization: Bearer <key> 鉴权。

模型规格

属性说明
模型 IDjina/jina-embeddings-v5-text-nano
可用别名jina-embeddings-v5-text-nano
上下文上限8,192 token(8K)
输出维度默认 768 维(API 支持 1–768,Matryoshka 推荐 32–768 维)
支持输入仅文本(兼容 OpenAI SDK 字符串、{ text } 对象与数组)
支持任务适配器retrieval.query、retrieval.passage、text-matching、clustering、classification
计费方式仅按总输入 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-v5-text-nano 或裸名别名 jina-embeddings-v5-text-nano。

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" | "clustering" | "classification"默认 "text-matching"

任务适配器优化方向:retrieval.query(检索查询)、retrieval.passage(检索文档)、text-matching(默认,语义匹配)、clustering(聚类)或 classification(分类)。

dimensionsinteger默认 768

输出向量维度(API 支持 1–768,Matryoshka 推荐截断范围 32–768,默认 768)。

embedding_type"float" | "base64" | "binary" | "ubinary" | array<"float" | "base64" | "binary" | "ubinary">

输出编码格式:float、base64、binary、ubinary,或由其组成的数组。

normalizedboolean默认 true

是否对输出向量执行 L2 归一化(默认 true)。

truncateboolean默认 false

输入超过 8K 上下文上限时是否自动尾部截断而非报错(默认 false)。

响应

200response

向量生成成功。

400response

请求参数不合法或输入超过上下文上限。

402response

工作区可用余额不足。

使用说明

适合大规模知识库入库与延迟敏感的在线检索,并与 Jina Embeddings v5 Omni Nano 向量空间互通。注意 v5 聚类任务标识为 clustering,且不提供 late_chunking 参数。

错误处理

错误响应采用 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-v5-text-nano",
    "task": "retrieval.passage",
    "input": [
      "Organic skincare for sensitive skin with aloe vera and chamomile."
    ]
  }'
{
  "object": "list",
  "model": "jina/jina-embeddings-v5-text-nano",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0123,
        -0.0456,
        0.0789
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "total_tokens": 14
  }
}