Amux AI

Jina Embeddings v5 Text Small

最近更新:2026年11月22日

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

Jina Embeddings v5 Text Small 是基于 Qwen3-0.6B-Base 的第五代主力多语言文本嵌入模型(677M 参数),采用末 token 池化(last-token pooling),支持 32K 长上下文、任务专用适配器与 Matryoshka 弹性维度截断(默认 1024 维,可截断至 32 维),并与 jina-embeddings-v5-omni-small 共享同一向量空间。

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

模型规格

属性说明
模型 IDjina/jina-embeddings-v5-text-small
可用别名jina-embeddings-v5-text-small
上下文上限32,768 token(32K)
输出维度默认 1024 维(API 支持 1–1024,Matryoshka 推荐 32–1024 维)
支持输入仅文本(兼容 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-small 或裸名别名 jina-embeddings-v5-text-small。

inputstring | object | array<string | object>必填

待嵌入的文本字符串、{ text } 对象或由其组成的数组(单条上限 32K 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默认 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

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

响应

200response

向量生成成功。

400response

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

402response

工作区可用余额不足。

使用说明

与 Jina Embeddings v5 Omni Small 对齐在同一向量空间,可先用本模型索引纯文本库,再直接用 Omni 模型检索图片、音频、视频或 PDF 而无需重建索引。注意 v5 聚类任务标识为 clustering(区别于 v3 的 separation),且不提供 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-small",
    "task": "retrieval.passage",
    "input": [
      "Organic skincare for sensitive skin with aloe vera and chamomile."
    ]
  }'
{
  "object": "list",
  "model": "jina/jina-embeddings-v5-text-small",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0123,
        -0.0456,
        0.0789
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "total_tokens": 14
  }
}