火山引擎Seedance本地接入代码实现操作步骤

需用STS临时凭证鉴权调用火山引擎Seedance：先创建AccessKey并授权TOS/Seedance权限，再调用STS获取Token；构造请求时手动签名需严格遵循HMAC-SHA256格式及ISO8601时间、x-content-sha256哈希规则，或使用volcengine SDK自动签名；请求体为含model_id、input（text必填）、parameters的JSON；响应为NDJSON流式格式，须按行解析，finish消息含final_result、usage和stop_reason。

要在本地开发环境中调用火山引擎Seedance服务，完成模型推理请求的构造、签名与发送，需严格遵循其HTTP API规范并正确实现STS临时凭证鉴权流程。

准备Seedance调用所需的认证凭据

登录火山引擎控制台，在「访问控制（IAM）→ 用户 → 安全凭证」中创建一对AccessKey ID和AccessKey Secret；【该密钥对具备账户级权限，切勿硬编码提交至Git或泄露在前端】。

进入「对象存储（TOS）→ 存储桶 → 权限管理 → 子用户授权策略」，为对应子用户附加预置策略：VolcEngineTOSFullAccess 和 VolcEngineSeedanceFullAccess。

调用STS服务获取临时Token：向 https://sts.volcengineapi.com 发起POST请求，Body中携带Action=AssumeRole、DurationSeconds=3600、RoleArn（格式为：arn:volcengine:iam::${account_id}:role/${role_name}）、RoleSessionName（如seedance_local_dev）。

构造符合Seedance要求的HTTP请求头

方法一：手动拼接Authorization签名头

① 按照“HMAC-SHA256 Credential=${access_key_id}/${date}/${region}/seedance/request, SignedHeaders=host;x-content-sha256;x-date, Signature=${signature}”格式组织Authorization值；

② x-date必须为ISO8601 UTC格式（如：20240520T081234Z），且与Date头一致；

③ x-content-sha256为请求体（不含换行）的SHA256哈希十六进制小写字符串，空请求体填e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855。

方法二：使用火山引擎最新SDK（推荐）

pip install volcengine；导入volcengine.seeds.SeedanceService，调用set_aksk(ak, sk, region="cn-north-1")后，SDK自动注入合法签名头。

发送标准JSON格式的推理请求

向 https://seedance.volcengineapi.com/api/v1/invoke 发起POST请求。

请求Body必须为合法JSON，包含以下字段：

– model_id：字符串，如seedance-1.5-pro；

– input：对象，含text字段（必填，最大长度2048字符）及可选image_url（支持TOS公网可读URL）；

– parameters：对象，temperature（0.1~1.0）、top_p（0.1~1.0）、max_new_tokens（1~2048）等均为浮点或整型数值，不可传字符串。

注意：若input.text为空字符串或仅含空白符，接口将直接返回400错误，不进入模型调度流程。

解析Seedance返回的流式响应

响应Header中Content-Type为application/json；若启用stream=true参数，响应Body为多行JSON（NDJSON），每行是一个{"type":"delta","data":"..."}或{"type":"finish","data":{}}对象。

逐行读取响应流时，必须按行分割（n），不可按字节缓冲截断；某一行JSON解析失败即终止处理，丢弃后续所有行。

finish类型消息中的data字段包含final_result（字符串）、usage（对象含input_tokens、output_tokens）、stop_reason（如"stop"或"length"）。