Genesis Docs

Models / Providers

Together AI

Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API.

Property Value
Provider together
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.

Run onboarding

genesis onboard --auth-choice together-api-key

Set a default model

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

Non-interactive example

genesis onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"

The onboarding preset sets together/moonshotai/Kimi-K2.5 as the default model.

Built-in catalog

Genesis ships this bundled Together catalog:

Model ref Name Input Context Notes
together/moonshotai/Kimi-K2.5 Kimi K2.5 text, image 262,144 Default model; reasoning enabled
together/zai-org/GLM-4.7 GLM 4.7 Fp8 text 202,752 General-purpose text model
together/meta-llama/Llama-3.3-70B-Instruct-Turbo Llama 3.3 70B Instruct Turbo text 131,072 Fast instruction model
together/meta-llama/Llama-4-Scout-17B-16E-Instruct Llama 4 Scout 17B 16E Instruct text, image 10,000,000 Multimodal
together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8 Llama 4 Maverick 17B 128E Instruct FP8 text, image 20,000,000 Multimodal
together/deepseek-ai/DeepSeek-V3.1 DeepSeek V3.1 text 131,072 General text model
together/deepseek-ai/DeepSeek-R1 DeepSeek R1 text 131,072 Reasoning model
together/moonshotai/Kimi-K2-Instruct-0905 Kimi K2-Instruct 0905 text 262,144 Secondary Kimi text model

Video generation

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

Property Value
Default video model together/Wan-AI/Wan2.2-T2V-A14B
Modes text-to-video, single-image reference
Supported parameters aspectRatio, resolution

To use Together as the default video provider:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        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 ~/.genesis/.env or via env.shellEnv).

Keys set only in your interactive shell are not visible to daemon-managed gateway processes. Use ~/.genesis/.env or env.shellEnv config for persistent availability.

Troubleshooting

  • Verify your key works: genesis 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>.