46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
---
|
|
title: OpenRouter
|
|
description: Instructions on how to integrate OpenRouter as a conversation agent
|
|
ha_category:
|
|
- Voice
|
|
ha_release: 2025.8
|
|
ha_iot_class: Cloud Polling
|
|
ha_config_flow: true
|
|
ha_codeowners:
|
|
- '@joostlek'
|
|
ha_domain: open_router
|
|
ha_integration_type: service
|
|
ha_platforms:
|
|
- ai_task
|
|
- conversation
|
|
ha_quality_scale: bronze
|
|
---
|
|
|
|
The [OpenRouter](https://openrouter.ai/) {% term integration %} allows you to use the OpenRouter API as a conversation agent in Home Assistant.
|
|
|
|
This integration provides a way to interact with a wide range of AI models available on OpenRouter, while billing is handled by OpenRouter.
|
|
You can even use your own third-party (like OpenAI) API key.
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
## Generate an API Key
|
|
|
|
The API key is used to authenticate requests to OpenRouter. To generate an API key take the following steps:
|
|
|
|
- Log in to [OpenRouter](https://openrouter.ai/) or sign up for an account.
|
|
- Go to the **API Keys** section in your account settings.
|
|
- To generate a new key, select **Create API Key**.
|
|
- Give the key a name, and be sure to set up billing limits.
|
|
|
|
# Supported functionality
|
|
|
|
## Generating data with AI
|
|
|
|
The OpenRouter integration allows you to generate data using AI models available on OpenRouter. You can use this functionality in automations, scripts, or directly in the Home Assistant UI.
|
|
|
|
## Removing the integration
|
|
|
|
This integration follows standard integration removal, no extra steps are required.
|
|
|
|
{% include integrations/remove_device_service.md %}
|