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. 运行入门设置
3. 设置默认模型
非交互式示例¶
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 仪表板、API 文档和定价。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw