home-assistant.io/source/_integrations/open_router.markdown

1.5 KiB

title description ha_category ha_release ha_iot_class ha_config_flow ha_codeowners ha_domain ha_integration_type ha_platforms ha_quality_scale
OpenRouter Instructions on how to integrate OpenRouter as a conversation agent
Voice
2025.8 Cloud Polling true
@joostlek
open_router service
ai_task
conversation
bronze

The OpenRouter {% 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 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 %}