# Together AI

> Together AI 设置（身份验证 + 模型选择）

- 网址：https://funcoding.ai/agents/openclaw/providers/together/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/together

---
[Together AI](https://together.ai) 通过统一 API 提供对领先开源模型的访问，包括 Llama、DeepSeek、Kimi 等。
OpenClaw 将其内置为 `together` 提供商。

| 属性 | 值                            |
| ---- | ----------------------------- |
| 提供商 | `together`           |
| 身份验证 | `TOGETHER_API_KEY`        |
| API | OpenAI 兼容                   |
| 基础 URL | `https://api.together.xyz/v1`        |

## 入门指南

**获取 API key**

在
[api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys) 创建 API key。

**运行新手引导**

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

**设置默认模型**

```json5
{
  agents: {
    defaults: {
      model: {
        primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo",
      },
    },
  },
}
```

### 非交互式示例

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"
```

<div class="callout callout-note">

新手引导会将 `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` 设置为
默认模型。

</div>

## 内置目录

费用单位为每百万 token 的美元价格。

| 模型引用                                           | 名称                         | 输入        | 上下文  | 最大输出   | 费用（输入/输出） | 说明             |
| -------------------------------------------------- | ---------------------------- | ----------- | ------- | ---------- | ----------------- | ---------------- |
| `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | Llama 3.3 70B Instruct Turbo | 文本        | 131,072 | 8,192      | 0.88 / 0.88       | 默认模型         |
| `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 | 8,192      | 2.10 / 4.40       | 推理模型         |
| `together/Qwen/Qwen2.5-7B-Instruct-Turbo`          | Qwen2.5 7B Instruct Turbo    | 文本        | 32,768  | 8,192      | 0.30 / 0.30       | 快速、非推理模型 |
| `together/zai-org/GLM-5.1`                         | GLM 5.1 FP4                  | 文本        | 202,752 | 8,192      | 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 设置为默认视频提供商：

```json5
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "together/Wan-AI/Wan2.2-T2V-A14B",
      },
    },
  },
}
```

<div class="callout callout-tip">

有关共享工具参数、提供商选择和故障转移行为，请参阅[视频生成](https://funcoding.ai/agents/openclaw/tools/video-generation/)。

</div>

<details>
<summary>环境说明</summary>

如果 Gateway 网关作为守护进程（launchd/systemd）运行，请确保该进程可以使用
`TOGETHER_API_KEY`（例如，将其放在
`~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。

<div class="callout callout-warning">

仅在交互式 shell 中设置的密钥对守护进程管理的 Gateway 网关
进程不可见。使用 `~/.openclaw/.env` 或 `env.shellEnv` 配置
以确保其持续可用。

</div>

</details>

<details>
<summary>故障排除</summary>

- 验证密钥是否有效：`openclaw models list --provider together`
- 如果模型未显示，请确认 API key 已设置在 Gateway 网关进程的正确
  环境中。
- 模型引用采用 `together/<model-id>` 格式。

</details>

## 相关内容

- [模型提供商](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：提供商规则、模型引用和故障转移行为。
- [视频生成](https://funcoding.ai/agents/openclaw/tools/video-generation/)：共享视频生成工具的参数和提供商选择。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/configuration-reference/)：完整的配置 schema，包括提供商设置。
- [Together AI](https://together.ai)：Together AI 控制面板、API 文档和定价。