跳转至

Together AI

Together AI 通过统一 API 提供对 Llama、DeepSeek、Kimi 等领先开源模型的访问。 OpenClaw 将其打包为 together 提供商。

属性 值
提供商 together(别名:togetherai)
认证 TOGETHER_API_KEY
API 兼容 OpenAI
基础 URL https://api.together.xyz/v1

快速入门

1. 获取 API 密钥

在 api.together.ai/settings/api-keys 创建 API 密钥。

2. 运行入门设置

openclaw onboard --auth-choice together-api-key

3. 设置默认模型

{
  agents: {
    defaults: {
      model: {
        primary: "together/moonshotai/Kimi-K2.6",
      },
    },
  },
}

非交互式示例

openclaw onboard --non-interactive --accept-risk --skip-health \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"

Note

入门设置会将 Together 推荐的聊天模型 together/moonshotai/Kimi-K2.6 设为默认。

内置目录

成本为每百万 token 的美元价格。

模型引用 名称 输入 上下文 最大输出 成本(输入/输出) 备注
together/meta-llama/Llama-3.3-70B-Instruct-Turbo Llama 3.3 70B Instruct Turbo 文本 131,072 8,192 1.04 / 1.04 通用模型
together/moonshotai/Kimi-K2.6 Kimi K2.6 FP4 文本、图像 262,144 32,768 1.20 / 4.50 默认模型
together/deepseek-ai/DeepSeek-V4-Pro DeepSeek V4 Pro 文本 512,000 384,000 1.74 / 3.48 推理模型
together/zai-org/GLM-5.2 GLM 5.2 FP4 文本 262,144 131,072 1.40 / 4.40 推理模型

视频生成

捆绑的 together 插件还通过共享的 video_generate 工具注册视频生成。

属性 值
默认视频模型 Wan-AI/Wan2.2-T2V-A14B
其他模型 Wan-AI/Wan2.2-I2V-A14B、minimax/hailuo-02、kwaivgI/kling-2.1-master
模式 文本转视频;仅 Wan-AI/Wan2.2-I2V-A14B 支持图像转视频(单张参考图像)
时长 1-10 秒
支持的参数 size(解析为 <width>x<height>);不读取 aspectRatio/resolution

要将 Together 用作默认视频提供商:

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "together/Wan-AI/Wan2.2-T2V-A14B",
        },
      },
    },
  },
}

Tip

有关共享工具参数、提供商选择和故障转移行为,请参阅 视频生成。

Prompt 缓存

Together 会自动重用匹配的 prompt 前缀。OpenClaw 会在原生 Together 请求中发送稳定的 prompt_cache_key,以改进跨轮次路由。缓存使用情况会根据模型的响应格式,从 usage.prompt_tokens_details.cached_tokens 和 usage.cached_tokens 中读取。为获得最佳 重用效果,请保持模型、工具定义、推理设置和较早消息稳定。请参阅 Together Prompt 缓存。

环境说明
如果 Gateway 作为守护进程(launchd/systemd)运行,请确保
`TOGETHER_API_KEY` 对该进程可用(例如,在
`~/.openclaw/.env` 中,或通过 `env.shellEnv`)。

Warning

仅在交互式 shell 中设置的密钥对由守护进程管理的 gateway 进程不可见。请使用 ~/.openclaw/.env 或 env.shellEnv 配置 以实现持久可用。

故障排查
  • 验证密钥是否可用:openclaw models list --provider together
  • 如果模型未出现,请确认 API 密钥已在 Gateway 进程的正确 环境中设置。
  • 模型引用使用 together/<model-id> 形式。

模型提供商

提供商规则、模型引用和故障转移行为。

视频生成

共享视频生成工具参数和提供商选择。

配置参考

包括提供商设置的完整配置模式。

Together AI

Together AI 仪表板、API 文档和定价。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw