文档中心

火山引擎SDK

SDK 介绍

什么是火山引擎 SDK

火山引擎 SDK（Software Development Kit）是火山引擎官方提供的多语言软件开发工具包，旨在帮助开发者以编程方式高效、安全地调用火山引擎云产品的 OpenAPI，无需关注底层签名算法和 HTTP 请求细节。让开发者可以专注于业务实现，大幅缩短接入云服务的开发周期。

V1 与 V2 SDK 版本介绍

火山引擎 SDK 目前提供 V1 和 V2 两个主要版本系列。两者在架构设计、使用体验和功能覆盖上存在显著差异。我们推荐您优先使用 V2 版本，各产品使用体验一致，开发接入成本更低。若 V2 版本中尚未覆盖您所需的云产品 SDK，可暂时使用 V1 版本。

	V2 版本 SDK（推荐）	V1 版本 SDK（不推荐）
整体介绍	V2 SDK 是火山引擎全新一代开发工具包，采用统一的架构设计和接口风格，为开发者提供一致的编程体验。	V1 SDK 是火山引擎早期发布的开发工具包。部分产品仍仅在 V1 中提供支持，随着 V2 的逐步完善，V1 将逐渐进入维护阶段。
核心优势/特点说明	统一架构：所有云产品 SDK 基于统一底层框架生成，接口风格、错误处理、配置方式完全一致强类型模型：请求参数和响应结果均为强类型对象，IDE 自动补全和编译时检查，减少运行时错误多种凭证管理：内置 CredentialProvider 机制，支持 AK/SK、STS AssumeRole、OIDC、ECS 实例角色等多种凭证来源完善的进阶能力：连接池、超时、重试、Debug 日志等均有标准化配置接口自动代码生成：基于 OpenAPI 元数据自动生成，API 更新后 SDK 可快速跟进活跃维护：持续更新，Bug 修复和安全补丁响应迅速	手动封装：各产品 SDK 独立开发维护，接口风格可能存在差异功能覆盖广：部分尚未迁移到 V2 的云产品仍仅在 V1 中提供维护状态：以安全补丁和关键 Bug 修复为主，新功能优先在 V2 中发布
仓库地址	Java： volcengine-java-sdk Go： volcengine-go-sdk Python： volcengine-python-sdk Node.js： volcengine-nodejs-sdk PHP： volcengine-php-sdk	Java： volc-sdk-java Go： volc-sdk-golang Python： volc-sdk-python Node.js： volc-sdk-nodejs PHP： volc-sdk-php
使用说明	Java：使用说明 Go：使用说明 Python：使用说明 Node.js：使用说明 PHP：使用说明	Java： Github README Go： Github README Python： Github README Node.js： Github README PHP： Github README

核心能力（V2 SDK）

高效接入

一键引入依赖，快速集成

自动化请求签名与身份认证

内置重试与容错机制

丰富的示例代码与开发指南

安全可靠

多种凭证管理方式（AK/SK、STS、OIDC等）

环境变量注入，避免密钥硬编码

支持 HTTPS 加密传输

严格遵循最小权限原则

灵活可控

支持自定义 Endpoint 与 Region

可配置超时、重试与连接池

完善的异常处理与 Debug 机制

支持代理和自定义 HTTP 客户端

持续演进

紧跟云服务 API 更新

语义化版本管理

定期安全更新与性能优化

完善的生命周期管理与升级指南

最近更新时间：2026.06.10 14:15:02

这个页面对您有帮助吗？

有用

无用