从写代码,到创作下一幕

探索 字节跳动 - 火山方舟 的 AI 编程与视频创作活动。

火山方舟 Agent Plan 与 Coding Plan 活动,价格 ¥9.9 起

Agent Plan & Coding Plan

一站体验多款热门模型,为 AI 编程与智能体开发提供更多选择。新用户可联系(微信: goo_lvyouyou)免费体验 9.9 agent plan。

查看套餐优惠
Seedance 2.5 视频创作活动:30 秒视频、多模态参考、局部编辑

Seedance 2.5

让创意,跃然成片。探索 30 秒视频、多模态参考与局部编辑,把脑海中的画面变成下一支作品。

探索视频创作

模型能力

临时 token

查看 Markdown

临时 token 为客户端应用提供安全、短时有效的身份验证。从浏览器或移动应用连接 Speech to Speech API 时请使用临时 token,以避免暴露 API key。


工作原理

  1. 你的 服务器 使用你的 API 密钥向 SpaceXSI 申请临时 token

  2. 服务器将临时 token 传递给 客户端

  3. 该 客户端 使用临时 token 验证 WebSocket 连接

  4. token 会在配置的时长后自动过期


创建临时 token

你需要设置一个服务端端点,从 SpaceXSI 获取临时 token。持有者可以在该 token 限定的范围内访问资源。

Endpoint: POST https://api.x.ai/v1/realtime/client_secrets

curl --url https://api.x.ai/v1/realtime/client_secrets \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  --data '{
    "expires_after": {
      "seconds": 300
    }
  }'

# Note: Does not support "session" or "expires_after.anchor" fields

使用临时 token

临时 token 的使用方式与 API key 相同:

import os
import websockets

base_url = "wss://api.x.ai/v1/realtime?model=grok-voice-latest"

# Connect with API key in Authorization header
async with websockets.connect(
    uri=base_url,
    ssl=True,
    additional_headers={"Authorization": f"Bearer {OBTAINED_EPHEMERAL_TOKEN}"}
) as websocket:
    # WebSocket connection is now authenticated
    pass

浏览器 WebSocket 身份验证

如果需要从浏览器发送临时 token,可以将带有前缀 xai-client-secret. 的临时 token 添加到 sec-websocket-protocol header:

JavaScript

new WebSocket("wss://api.x.ai/v1/realtime", [\`xai-client-secret.\${OBTAINED_EPHEMERAL_TOKEN}\`]);

最后更新:2026 年 10 月 10 日