From 560340f30b61db49cea6dea1a490f383f57302be Mon Sep 17 00:00:00 2001 From: Brandon Zarnitz Date: Tue, 5 May 2026 17:52:08 -0400 Subject: [PATCH] =?UTF-8?q?docs(llms):=20fix=20OpenRouter=20example=20?= =?UTF-8?q?=E2=80=94=20NameError,=20redundant=20base=5Furl,=20add=20thinki?= =?UTF-8?q?ng=20note?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The OpenRouter accordion in all four language versions of `concepts/llms.mdx` contained `api_key=OPENROUTER_API_KEY` — a bare Python variable reference that is never imported, causing a `NameError` for any user who copies the snippet verbatim. The `base_url` parameter was also hardcoded to the default value that the provider already sets automatically. Changes across docs/en, docs/ar, docs/pt-BR, docs/ko: - Replace `api_key=OPENROUTER_API_KEY` with comments explaining the auto-resolve behavior (reads from `OPENROUTER_API_KEY` env var; `base_url` auto-configured) - Add `from crewai import LLM` import to the example - Add extended-thinking example for OpenRouter + Anthropic models, noting the `thinking` param works for any LiteLLM-routed provider (now that the `_prepare_completion_params` forwarding bug is fixed) - Expand the model list to include `openrouter/anthropic/claude-sonnet-4-5` Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/ar/concepts/llms.mdx | 7 +++++-- docs/en/concepts/llms.mdx | 19 +++++++++++++++++-- docs/ko/concepts/llms.mdx | 7 +++++-- docs/pt-BR/concepts/llms.mdx | 7 +++++-- 4 files changed, 32 insertions(+), 8 deletions(-) diff --git a/docs/ar/concepts/llms.mdx b/docs/ar/concepts/llms.mdx index 0070b6b9f1..33dda1d79a 100644 --- a/docs/ar/concepts/llms.mdx +++ b/docs/ar/concepts/llms.mdx @@ -1080,10 +1080,12 @@ mode: "wide" مثال الاستخدام في مشروع CrewAI: ```python Code + from crewai import LLM + llm = LLM( model="openrouter/deepseek/deepseek-r1", - base_url="https://openrouter.ai/api/v1", - api_key=OPENROUTER_API_KEY + # api_key defaults to OPENROUTER_API_KEY env var + # base_url defaults to https://openrouter.ai/api/v1 ) ``` @@ -1091,6 +1093,7 @@ mode: "wide" نماذج Open Router: - openrouter/deepseek/deepseek-r1 - openrouter/deepseek/deepseek-chat + - openrouter/anthropic/claude-sonnet-4-5 **ملاحظة:** يستخدم هذا المزود LiteLLM. أضفه كتبعية لمشروعك: diff --git a/docs/en/concepts/llms.mdx b/docs/en/concepts/llms.mdx index 98bfbeb234..54f152ed94 100644 --- a/docs/en/concepts/llms.mdx +++ b/docs/en/concepts/llms.mdx @@ -1144,10 +1144,23 @@ In this section, you'll find detailed examples that help you select, configure, Example usage in your CrewAI project: ```python Code + from crewai import LLM + llm = LLM( model="openrouter/deepseek/deepseek-r1", - base_url="https://openrouter.ai/api/v1", - api_key=OPENROUTER_API_KEY + # api_key defaults to OPENROUTER_API_KEY env var + # base_url defaults to https://openrouter.ai/api/v1 + ) + ``` + + Extended thinking is supported for Anthropic models routed via OpenRouter: + ```python Code + from crewai import LLM + + llm = LLM( + model="openrouter/anthropic/claude-sonnet-4-5", + thinking={"type": "enabled", "budget_tokens": 5000}, + max_tokens=10000, ) ``` @@ -1155,6 +1168,8 @@ In this section, you'll find detailed examples that help you select, configure, Open Router models: - openrouter/deepseek/deepseek-r1 - openrouter/deepseek/deepseek-chat + - openrouter/anthropic/claude-sonnet-4-5 + - openrouter/anthropic/claude-opus-4-5 **Note:** This provider uses LiteLLM. Add it as a dependency to your project: diff --git a/docs/ko/concepts/llms.mdx b/docs/ko/concepts/llms.mdx index 77e71d5182..cf6f8403fa 100644 --- a/docs/ko/concepts/llms.mdx +++ b/docs/ko/concepts/llms.mdx @@ -817,10 +817,12 @@ CrewAI는 고유한 기능, 인증 방법, 모델 역량을 제공하는 다양 CrewAI 프로젝트에서의 예시 사용법: ```python Code + from crewai import LLM + llm = LLM( model="openrouter/deepseek/deepseek-r1", - base_url="https://openrouter.ai/api/v1", - api_key=OPENROUTER_API_KEY + # api_key defaults to OPENROUTER_API_KEY env var + # base_url defaults to https://openrouter.ai/api/v1 ) ``` @@ -828,6 +830,7 @@ CrewAI는 고유한 기능, 인증 방법, 모델 역량을 제공하는 다양 Open Router 모델: - openrouter/deepseek/deepseek-r1 - openrouter/deepseek/deepseek-chat + - openrouter/anthropic/claude-sonnet-4-5 **참고:** 이 제공자는 LiteLLM을 사용합니다. 프로젝트에 의존성으로 추가하세요: diff --git a/docs/pt-BR/concepts/llms.mdx b/docs/pt-BR/concepts/llms.mdx index 22f267c937..1a3346fa2b 100644 --- a/docs/pt-BR/concepts/llms.mdx +++ b/docs/pt-BR/concepts/llms.mdx @@ -816,10 +816,12 @@ Nesta seção, você encontrará exemplos detalhados que ajudam a selecionar, co Exemplo de uso em seu projeto CrewAI: ```python Code + from crewai import LLM + llm = LLM( model="openrouter/deepseek/deepseek-r1", - base_url="https://openrouter.ai/api/v1", - api_key=OPENROUTER_API_KEY + # api_key defaults to OPENROUTER_API_KEY env var + # base_url defaults to https://openrouter.ai/api/v1 ) ``` @@ -827,6 +829,7 @@ Nesta seção, você encontrará exemplos detalhados que ajudam a selecionar, co Modelos do Open Router: - openrouter/deepseek/deepseek-r1 - openrouter/deepseek/deepseek-chat + - openrouter/anthropic/claude-sonnet-4-5 **Nota:** Este provedor usa o LiteLLM. Adicione-o como dependência ao seu projeto: