Niektóre wtyczki i rozwiązania, które wykorzystują zewnętrzne zasoby wymagają zastosowania kluczy API.
> [!INFO] Co to klucz API?
>
> Klucz API, czyli klucz interfejsu programistycznego aplikacji, to **fragment kodu oprogramowania**. Pozwala zidentyfikować użytkownika lub maszynę, która wywołuje komunikację. Najczęściej ma postać wygenerowanego ciągu znaków.
Klucze API pozwalają w Twoim systemie (w Obsidianie) wykorzystywać technologię innych dostawców. Dostawcami usług i kluczy API są przede wszystkim największe firmy technologiczne (ale nie tylko), w Obsidianie często można spotkać się z wykorzystaniem rozwiązań:
- **Googl**e (Cloud)
- **Amazon** (AWS)
- **Microsoft** (Azure)
- **OpenAI** (Wykorzystanie API GPT)
- **DeepL** (translator)
a także wielu bardziej niszowych.
# Czy potrzebuję klucza API?
Do niektórych rozwiązań, takich jak AI lub tłumaczenia — **tak**.
>[!tip] Wskazówka
> **Wykorzystywanie kluczy API może wiązać się z dodatkowymi opłatami** (tak jest w przypadku sztucznej inteligencji.
>
> Duże platformy jak Microsoft, czy Google udostępniają darmowe kredyty i limity dla deweloperów, dzięki którym korzystanie z kluczy API tych firm może okazać się efektywnie darmowe.
Z przedstawionych rozwiązań część z nich wykorzystuje klucze API, są to:
- **[[Text Generator (Obsidian)|Text Generator (Obsidian)]]** - należy wybrać dostawcę modela językowego do wtyczki. Do wyboru użytkownika są różne modele w ramach: [OpenAI](https://platform.openai.com/), [Google](https://ai.google.dev/), [Ollama](https://github.com/ollama/ollama/blob/main/docs/api.md), [Mistral AI](https://docs.mistral.ai/api/), [Anthropic](https://www.anthropic.com/api) i [Azure](https://www.microsoft.com/en-us/bing/apis/bing-web-search-api). Istnieje możliwość także własnej konfiguracji — z modelem lokalnym i pracę ze sztuczną inteligencją offline. Klucze API do rozwiązań
- **Translate** - klucz API potrzebny jest, aby podłączyć się do chmurowej usługi tłumaczeń. Do wyboru użytkownika jest wiele rozwiązań. Klucze API dla tłumaczeń często mają swoje darmowe wersje (np. Microsoft Azure pozwala korzystać z [usługi tłumaczenia via API](https://www.microsoft.com/en-us/translator/business/translator-api/) z limitem znaków - 2 000 000 miesięcznie w ramach darmowego limitu).
- **Language Tool Integration** - klucz API, który nie jest wymagany, ale pozyskanie go ze swojego panelu pozwala spersonalizować użytkowanie o osobisty słownik, własne zasady itd.
---
# Jak pozyskać klucz API
Każdy dostawca usług za pośrednictwem kluczy API posiada pełną dokumentację związaną z konfigurowaniem systemu. Poniżej wymienione (nie wszystkie) dokumentacje API dla wtyczek wykorzystujących je:
**Text Generator**
- [OpenAI](https://platform.openai.com/)
- [Google](https://ai.google.dev/)
- [Ollama](https://github.com/ollama/ollama/blob/main/docs/api.md)
- [Mistral AI](https://docs.mistral.ai/api/)
- [Anthropic](https://www.anthropic.com/api)
- [Microsoft Azure](https://www.microsoft.com/en-us/bing/apis/bing-web-search-api)
**Translate**
- [Translator Text API (Microsfot Azure)](https://www.microsoft.com/en-us/translator/business/translator-api/)
- [Cloud Translation (Google)](https://cloud.google.com/translate/docs/reference/rest/)
- [Yandex Translate](https://yandex.com/dev/translate/)
- [DeepL API](https://www.deepl.com/pro-api)
**Language Tool Integration**
- [Language Tool API](https://languagetool.org/proofreading-api)
>[!todo] Poradnik
>[[Licencje (Obsidian)]]