Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API. Apus bundles it as the together provider.

Property Value
Provider together (alias: togetherai)
Auth TOGETHER_API_KEY
API OpenAI-compatible
Base URL https://api.together.xyz/v1

Getting started

Get an API key

Create an API key at
[api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys).

Run onboarding

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

Set a default model

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

Non-interactive example

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

Onboarding sets Together's recommended chat model, together/moonshotai/Kimi-K2.6, as the default.

Built-in catalog

Cost is USD per million tokens.

Model ref Name Input Context Max output Cost (in/out) Notes
together/meta-llama/Llama-3.3-70B-Instruct-Turbo Llama 3.3 70B Instruct Turbo text 131,072 8,192 1.04 / 1.04 General model
together/moonshotai/Kimi-K2.6 Kimi K2.6 FP4 text, image 262,144 32,768 1.20 / 4.50 Default model
together/deepseek-ai/DeepSeek-V4-Pro DeepSeek V4 Pro text 512,000 384,000 1.74 / 3.48 Reasoning model
together/zai-org/GLM-5.2 GLM 5.2 FP4 text 262,144 131,072 1.40 / 4.40 Reasoning model

Video generation

The bundled together plugin also registers video generation through the shared video_generate tool.

Property Value
Default video model Wan-AI/Wan2.2-T2V-A14B
Other models Wan-AI/Wan2.2-I2V-A14B, minimax/hailuo-02, kwaivgI/kling-2.1-master
Modes text-to-video; image-to-video only with Wan-AI/Wan2.2-I2V-A14B (single reference image)
Duration 1-10 seconds
Supported parameters size (parsed as <width>x<height>); aspectRatio/resolution are not read

To use Together as the default video provider:

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

See Video generation for the shared tool parameters, provider selection, and failover behavior.

Environment note 
If the Gateway runs as a daemon (launchd/systemd), make sure
`TOGETHER_API_KEY` is available to that process (for example, in
`~/.apus/.env` or via `env.shellEnv`).

Keys set only in your interactive shell are not visible to daemon-managed
gateway processes. Use `~/.apus/.env` or `env.shellEnv` config for
persistent availability.
Troubleshooting 
- Verify your key works: `apus models list --provider together`
- If models are not appearing, confirm the API key is set in the correct
  environment for your Gateway process.
- Model refs use the form `together/<model-id>`.

Related

Model providers

Provider rules, model refs, and failover behavior.

Video generation

Shared video generation tool parameters and provider selection.

Configuration reference

Full config schema including provider settings.

Together AI

Together AI dashboard, API docs, and pricing.