> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkAI

> Access text, vision, image, speech, and embedding capabilities through the LinkAI platform

A single `linkai_api_key` gives you access to all capabilities of mainstream providers such as OpenAI, Claude, Gemini, DeepSeek, MiniMax, Qwen, Kimi, and Doubao.

<Tip>
  All capabilities below can be configured in one place via the "Model Management" page in the Web Console, with no need to manually edit the configuration file.
</Tip>

## Text Chat

```json theme={null}
{
  "use_linkai": true,
  "linkai_api_key": "YOUR_API_KEY"
}
```

| Parameter        | Description                                                                |
| ---------------- | -------------------------------------------------------------------------- |
| `use_linkai`     | Set to `true` to enable                                                    |
| `linkai_api_key` | Create one in the [Console](https://link-ai.tech/console/interface)        |
| `model`          | Can be any code from the [model list](https://link-ai.tech/console/models) |

See [Model Service](https://link-ai.tech/console/models) for more.

## Image Understanding

Once configured, the Agent's Vision tool automatically calls multimodal models via the gateway, with no extra setup required. To manually specify a Vision model:

```json theme={null}
{
  "tools": {
    "vision": {
      "model": "gpt-5.4-mini"
    }
  }
}
```

Available models: `gpt-4.1-mini`, `gpt-5.4-mini`, `qwen3.7-plus`, `doubao-seed-2-1-pro-260628`, `kimi-k2.6`, `claude-sonnet-5`, `gemini-3.1-flash-lite-preview`, etc.

## Image Generation

```json theme={null}
{
  "skills": {
    "image-generation": {
      "model": "gpt-image-2"
    }
  }
}
```

| Model ID                         | Alias                     |
| -------------------------------- | ------------------------- |
| `gpt-image-2`                    | OpenAI                    |
| `gemini-3.1-flash-image-preview` | Nano Banana 2             |
| `gemini-3-pro-image-preview`     | Nano Banana Pro           |
| `seedream-5.0-lite`              | ByteDance Doubao Seedream |

## Speech-to-Text (ASR)

```json theme={null}
{
  "voice_to_text": "linkai"
}
```

ASR uses Whisper by default; credentials are automatically reused from `linkai_api_key`.

## Text-to-Speech (TTS)

The TTS gateway supports multiple underlying engines. The engine is selected by `text_to_voice_model`, and the available voices change with the engine.

```json theme={null}
{
  "text_to_voice": "linkai",
  "text_to_voice_model": "doubao",
  "tts_voice_id": "BV001_streaming"
}
```

| `text_to_voice_model` | Engine                                                                |
| --------------------- | --------------------------------------------------------------------- |
| `tts-1`               | OpenAI · Multi-language (voices like `alloy` / `nova` / `echo`, etc.) |
| `doubao`              | ByteDance Doubao · Rich Chinese voices                                |
| `baidu`               | Baidu · Chinese broadcaster voices                                    |

Voices differ by engine; we recommend selecting them visually in the Web Console under "Model Management → Text-to-Speech".

## Embedding

```json theme={null}
{
  "embedding_provider": "linkai",
  "embedding_model": "text-embedding-3-small"
}
```

The default model is `text-embedding-3-small` (OpenAI-compatible). After changing the embedding, run `/memory rebuild-index` to rebuild the index.