Skip to content

fix: correct Volcengine sparse/hybrid embedder and update sparse model docs#561

Merged
MaojiaSheng merged 2 commits intovolcengine:mainfrom
yangxinxin-7:feat/sparse
Mar 12, 2026
Merged

fix: correct Volcengine sparse/hybrid embedder and update sparse model docs#561
MaojiaSheng merged 2 commits intovolcengine:mainfrom
yangxinxin-7:feat/sparse

Conversation

@yangxinxin-7
Copy link
Copy Markdown
Collaborator

**Bug fixes / 问题修复:**
- Fix `Ark()` init crash when `api_base` is None by only passing `base_url` when set
  修复 `api_base` 为 None 时 `Ark()` 初始化崩溃问题,仅在有值时传入 `base_url`
- Fix `VolcengineSparseEmbedder.embed()` using `response.data[0]` — the multimodal
  API always returns a single object, not a list
  修复 `embed()` 错误使用 `response.data[0]`,multimodal API 始终返回单个对象而非列表
- Fix `embed_batch()` for sparse and hybrid embedders: the multimodal API input array
  is for multi-modal inputs of a single sample, not batching; delegate to `embed()` per text
  修复 Sparse/Hybrid 的 `embed_batch()`:multimodal API 的 input 数组是单样本多模态输入,
  不支持 batch,改为逐条调用 `embed()`

**Docs / 文档:**
- Update sparse model from `bm25-sparse-v1` to `doubao-embedding-vision-250615` in EN/ZH docs
  中英文文档中 sparse 模型由 `bm25-sparse-v1` 更新为 `doubao-embedding-vision-250615`
- Add note that Volcengine sparse embedding is supported from `doubao-embedding-vision-250615`
  and only supports text input
  新增说明:火山引擎 Sparse embedding 从 `doubao-embedding-vision-250615` 起支持,仅支持文本输入

…l docs

修复火山引擎 Sparse/Hybrid Embedder 并更新 Sparse 模型文档

**Bug fixes / 问题修复:**
- Fix `Ark()` init crash when `api_base` is None by only passing `base_url` when set
  修复 `api_base` 为 None 时 `Ark()` 初始化崩溃问题,仅在有值时传入 `base_url`
- Fix `VolcengineSparseEmbedder.embed()` using `response.data[0]` — the multimodal
  API always returns a single object, not a list
  修复 `embed()` 错误使用 `response.data[0]`,multimodal API 始终返回单个对象而非列表
- Fix `embed_batch()` for sparse and hybrid embedders: the multimodal API input array
  is for multi-modal inputs of a single sample, not batching; delegate to `embed()` per text
  修复 Sparse/Hybrid 的 `embed_batch()`:multimodal API 的 input 数组是单样本多模态输入,
  不支持 batch,改为逐条调用 `embed()`

**Docs / 文档:**
- Update sparse model from `bm25-sparse-v1` to `doubao-embedding-vision-250615` in EN/ZH docs
  中英文文档中 sparse 模型由 `bm25-sparse-v1` 更新为 `doubao-embedding-vision-250615`
- Add note that Volcengine sparse embedding is supported from `doubao-embedding-vision-250615`
  and only supports text input
  新增说明:火山引擎 Sparse embedding 从 `doubao-embedding-vision-250615` 起支持,仅支持文本输入

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
文档:移除 Sparse embedding 中仅支持文本输入的限制说明

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@MaojiaSheng MaojiaSheng merged commit e46eeaf into volcengine:main Mar 12, 2026
6 checks passed
@github-project-automation github-project-automation bot moved this from Backlog to Done in OpenViking project Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants