Nonli udostępnia cztery funkcje pomocnicze Twig do generowania tekstu: gpt(), claude(), gemini() i mistral(). Każda z nich przyjmuje prompt i opcjonalny identyfikator modelu dostawcy:
1{{ gpt('Write one factual sentence.', 'gpt-5.6-luna') }}Jeśli pominiesz drugi argument, Nonli użyje wdrożonego modelu zastępczego. Poniższe opcjonalne przykłady to wyselekcjonowany punkt wyjścia, a nie lista dozwolonych modeli Nonli: faktyczny dostęp, ceny, regiony, limity zapytań i daty wycofania zależą od Twojego konta u dostawcy i klucza API.
1. Aktualne zestawienie#
| Funkcja pomocnicza dostawcy | Wdrożony model zastępczy Nonli przy pominięciu modelu | Aktualne zgodne przykłady | Wskazówki dotyczące cyklu życia |
|---|---|---|---|
gpt() | gpt-4o | gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna | gpt-5.6 to ruchomy alias rodziny modeli; użyj nazwanego wariantu, gdy potrzebujesz bardziej jednoznacznego wyboru między możliwościami a kosztem. |
claude() | claude-sonnet-4-5-20250929 | claude-fable-5, claude-opus-5, claude-sonnet-5, claude-haiku-4-5-20251001 | Identyfikatory Claude 5 od Anthropic bez daty są przypiętymi identyfikatorami modeli; identyfikator Haiku z datą to jawnie wskazana wersja (snapshot). |
gemini() | gemini-3.7-flash | gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash | W środowisku produkcyjnym wybieraj wersje stabilne. Identyfikatory w wersji preview i eksperymentalne mogą się zmienić lub zniknąć z krótszym wyprzedzeniem. |
mistral() | mistral-large-latest | mistral-medium-3-5, mistral-small-2603, mistral-large-2512 | latest to ruchomy alias; identyfikatory z datą lub numerem wersji lepiej zapewniają powtarzalne działanie. |
Modele zastępcze opisują wdrożone działanie Nonli, a nie rekomendacje poszczególnych dostawców. Jeśli dostawca wycofa model zastępczy lub Twój klucz nie może z niego korzystać, przekaż model, do którego masz dostęp, i po przetestowaniu zaktualizuj szablon.
2. Przykłady do skopiowania#
2.1. OpenAI#
1{# Omitted model: Nonli uses gpt-4o #}2{{ gpt('Return only a neutral, factual headline.') }}3
4{# Explicit current model #}5{{ gpt('Return only a neutral, factual headline.', 'gpt-5.6-luna') }}Zobacz oficjalny katalog modeli OpenAI.
2.2. Anthropic Claude#
1{# Omitted model: Nonli uses claude-sonnet-4-5-20250929 #}2{{ claude('Return only a neutral, factual headline.') }}3
4{# Explicit current model #}5{{ claude('Return only a neutral, factual headline.', 'claude-sonnet-5') }}Zobacz oficjalny przegląd modeli Anthropic.
2.3. Google Gemini#
1{# Omitted model: Nonli uses gemini-3.7-flash #}2{{ gemini('Return only a neutral, factual headline.') }}3
4{# Explicit stable model #}5{{ gemini('Return only a neutral, factual headline.', 'gemini-3.6-flash') }}Zobacz oficjalny katalog modeli Gemini.
2.4. Mistral AI#
1{# Omitted model: Nonli uses mistral-large-latest #}2{{ mistral('Return only a neutral, factual headline.') }}3
4{# Explicit versioned model #}5{{ mistral('Return only a neutral, factual headline.', 'mistral-medium-3-5') }}Zobacz oficjalny katalog modeli Mistral.
3. Który identyfikator wybrać?#
- Pomijaj model tylko wtedy, gdy akceptujesz, że Nonli może zaktualizować model zastępczy po jego wycofaniu przez dostawcę.
- Używaj stabilnego aliasu, gdy chcesz korzystać z aktualizacji zarządzanych przez dostawcę i możesz z czasem przeprowadzać testy regresji wyników.
- Używaj przypiętego lub wersjonowanego identyfikatora, gdy liczy się powtarzalność, a przed wycofaniem modelu zaplanuj przemyślaną migrację.
- Modeli w wersji preview lub eksperymentalnych używaj wyłącznie w kontrolowanych testach. Nie uzależniaj od nich środowiska produkcyjnego bez modelu zastępczego.
- Wybieraj wyłącznie modele do generowania tekstu i wiadomości. Modele do obrazów, dźwięku, TTS, embeddingów, moderacji, OCR, wideo oraz modele przeznaczone tylko dla agentów nie są zgodne z tymi funkcjami pomocniczymi.
Gdy nie są dostępne żadne dane uwierzytelniające dostawcy, funkcja pomocnicza może nie zwrócić żadnej treści. W bardziej rygorystycznych kontekstach wykonania brakujący lub nieprawidłowy token, niedostępny model, limit zapytań lub błąd dostawcy mogą przerwać renderowanie z błędem. W ważnych szablonach zawsze zachowuj deterministyczny wariant zastępczy i testuj na tym samym koncie dostawcy, z którego korzysta Twoja marka.
4. Kontynuuj proces pracy#
- Utwórz i przetestuj Smart Message
- Jakie zmienne Twig są dostępne w Nonli?, w tym jak zapisywać apostrofy w prompcie
- Utwórz klucz API OpenAI dla Nonli
- Skonfiguruj i przetestuj Publish Guard