Genesis Docs

Arcee AI provides access to the Trinity family of mixture-of-experts models through an OpenAI-compatible API. All Trinity models are Apache 2.0 licensed.

Arcee AI models can be accessed directly via the Arcee platform or through OpenRouter.

Property Value
Provider arcee
Auth ARCEEAI_API_KEY (direct) or OPENROUTER_API_KEY (via OpenRouter)
API OpenAI-compatible
Base URL https://api.arcee.ai/api/v1 (direct) or https://openrouter.ai/api/v1 (OpenRouter)

Getting started

Direct (Arcee platform)

Get an API key

    Create an API key at [Arcee AI](https://chat.arcee.ai/).

Run onboarding

    ```bash
    genesis onboard --auth-choice arceeai-api-key
    ```

Set a default model

    ```json5
    {
      agents: {
        defaults: {
          model: { primary: "arcee/trinity-large-thinking" },
        },
      },
    }
    ```

Via OpenRouter

Get an API key

    Create an API key at [OpenRouter](https://openrouter.ai/keys).

Run onboarding

    ```bash
    genesis onboard --auth-choice arceeai-openrouter
    ```

Set a default model

    ```json5
    {
      agents: {
        defaults: {
          model: { primary: "arcee/trinity-large-thinking" },
        },
      },
    }
    ```

    The same model refs work for both direct and OpenRouter setups (for example `arcee/trinity-large-thinking`).

Non-interactive setup

Direct (Arcee platform)

```bash
genesis onboard --non-interactive \
  --mode local \
  --auth-choice arceeai-api-key \
  --arceeai-api-key "$ARCEEAI_API_KEY"
```

Via OpenRouter

```bash
genesis onboard --non-interactive \
  --mode local \
  --auth-choice arceeai-openrouter \
  --openrouter-api-key "$OPENROUTER_API_KEY"
```

Built-in catalog

Genesis currently ships this bundled Arcee catalog:

Model ref Name Input Context Cost (in/out per 1M) Notes
arcee/trinity-large-thinking Trinity Large Thinking text 256K $0.25 / $0.90 Default model; reasoning enabled
arcee/trinity-large-preview Trinity Large Preview text 128K $0.25 / $1.00 General-purpose; 400B params, 13B active
arcee/trinity-mini Trinity Mini 26B text 128K $0.045 / $0.15 Fast and cost-efficient; function calling
The onboarding preset sets `arcee/trinity-large-thinking` as the default model.

Supported features

Feature Supported
Streaming Yes
Tool use / function calling Yes
Structured output (JSON mode and JSON schema) Yes
Extended thinking Yes (Trinity Large Thinking)

Environment note

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

OpenRouter routing

When using Arcee models via OpenRouter, the same `arcee/*` model refs apply.
Genesis handles routing transparently based on your auth choice. See the
[OpenRouter provider docs](/providers/openrouter) for OpenRouter-specific
configuration details.

Related

  • OpenRouter Access Arcee models and many others through a single API key.

  • Model selection Choosing providers, model refs, and failover behavior.