豆包向量化API由字节跳动研发的语义向量化模型

作者:互联网

2026-03-20

⼤语⾔模型脚本

豆包向量化API是一款强大的语义向量化工具,支持中英文文本处理,为开发者提供高效的向量检索解决方案。本文将详细介绍其功能特点和使用方法。

豆包向量化API技术解析

Doubao-embedding是由字节跳动开发的语义向量化模型,支持中英双语处理,最大可处理4096字符的上下文。目前提供两个版本:text-240715最高支持2560维向量,支持512/1024/2048维降维使用;text-240515最高支持2048维向量,支持512/1024维降维使用。API访问地址为maas-api.ml-platform-cn-beijing.volces.com,服务区域为cn-beijing

使用前需配置VOLC_ACCESSKEYVOLC_SECRETKEY环境变量。官方提供了Golang、Python和Java三种语言的SDK支持。

核心功能特性

  1. 语义向量转换:将文本内容转换为具有语义特征的向量表示。
  2. 多语言支持:完美兼容中文和英文文本处理需求。
  3. 长文本处理:最大支持4096字符的上下文处理能力。
  4. 维度可调:提供2048维原生向量,支持512/1024维降维输出。
  5. 检索优化:专为文档相似度比较和信息检索场景优化设计。
  6. 开发友好:提供Golang/Python/Java三种主流语言SDK。
  7. 输入输出灵活:支持批量文本输入,返回带序号的向量结果。
  8. 检索增强:建议为查询文本添加特定指令前缀提升效果。
  9. 场景广泛:适用于搜索引擎、推荐系统、知识图谱等多种应用。

官方文档地址

  1. API调用指南:https://www.volcengine.com/docs/82379/1263524

API密钥获取流程

API Key是身份验证的重要凭证,调用时需在Header中添加Authorization字段,并将VOLC_ACCESSKEY替换为实际密钥。

  1. 账号注册:完成火山引擎官网账号注册
  2. 控制台登录:使用注册账号登录管理后台
  3. 密钥创建:在API访问秘钥版块创建新密钥,设置识别名称并妥善保管生成的密钥

多语言SDK接入指南

  1. Golang集成方案
    1. SDK安装:执行go get命令获取SDK
      go get -u github.com/volcengine/volc-sdk-golang
    2. 密钥配置:代码中设置访问凭证
      package main
      import (
          "encoding/json"
          "errors"
          "fmt"
          "os"
          api "github.com/volcengine/volc-sdk-golang/service/maas/models/api/v2"
          client "github.com/volcengine/volc-sdk-golang/service/maas/v2"
      )
      func main() {
          r := client.NewInstance("maas-api.ml-platform-cn-beijing.volces.com", "cn-beijing")
          r.SetAccessKey(os.Getenv("VOLC_ACCESSKEY"))
          r.SetSecretKey(os.Getenv("VOLC_SECRETKEY"))
          req := &api.EmbeddingsReq{
              Input: []string{
                  "天很蓝",
                  "海很深",
              },
          }
          endpointId := "{YOUR_ENDPOINT_ID}"
          TestEmbeddings(r, endpointId, req)
      }
      func TestEmbeddings(r *client.MaaS, endpointId string, req *api.EmbeddingsReq) {
          if got, status, err := r.Embeddings(endpointId, req); err != nil {
              errVal := &api.Error{}
              if errors.As(
      							                            

      相关标签:

      豆包