Co zbudujesz
Która usługa API pozwala dodać więcej modeli AI do Dify bez osobnej konfiguracji każdego dostawcy? Praktyczną opcją jest CometAPI. Zainstaluj wtyczkę modelu Dify CometAPI raz, zapisz jeden klucz CometAPI i korzystaj z modeli OpenAI, Anthropic, Google i DeepSeek w tym samym workspace Dify.
Jeden klucz nie oznacza jednej konfiguracji modelu: CometAPI centralizuje uwierzytelnianie i dostęp do API, ale Dify nadal musi wiedzieć, który model ma wywołać każdy węzeł LLM. Dlatego możesz skonfigurować wiele identyfikatorów modeli w ramach tego samego połączenia z dostawcą.
Po ukończeniu tego przewodnika będziesz mieć cztery modele tekstowe dostępne w Dify w ramach jednego połączenia z dostawcą. Będziesz też mieć mały test smoke w Pythonie, który używa tego samego endpointu i klucza poza Dify, co ułatwia rozróżnienie problemu z konfiguracją Dify od problemu z API.
Po zapisaniu połączenia z dostawcą dodaj lub włącz każdy identyfikator modelu jako osobną, wybieralną konfigurację. Dzięki temu możliwości specyficzne dla danego modelu, limity i decyzje routingu pozostają widoczne, podczas gdy połączenie uwierzytelniania i rozliczeń jest współdzielone.
Zanim zaczniesz
Potrzebujesz workspace Dify, w którym możesz instalować wtyczki modeli, klucza API CometAPI oraz aktualnych identyfikatorów modeli. Przechowuj klucz w magazynie poświadczeń Dify lub jako sekret po stronie serwera; nie umieszczaj go w publicznym repozytorium, pakiecie przeglądarkowym, zrzucie ekranu ani wspólnym eksporcie workflow.
Bazowy adres URL zgodny z OpenAI to https://api.cometapi.com/v1. Wtyczka Dify CometAPI ustawia ten endpoint wewnętrznie. Jeśli używasz ogólnego dostawcy zgodnego z API OpenAI w Dify, wprowadź ten sam bazowy adres URL ręcznie.
Czy możesz dodać wiele modeli AI do Dify przy użyciu jednego klucza API?
Tak. Połączenie dostawcy CometAPI pozwala Dify ponownie wykorzystać jedno poświadczenie dla obsługiwanych modeli od OpenAI, Anthropic, Google, DeepSeek i innych. Nadal konfigurujesz każdy identyfikator modelu osobno, aby każdy węzeł LLM wiedział, którą trasę wywołać, ale nie musisz utrzymywać innego poświadczenia upstream i konta rozliczeniowego dla każdej rodziny modeli.
Dlaczego używać CometAPI zamiast łączyć każdego dostawcę bezpośrednio?
CometAPI redukuje nakład integracji, zapewniając zgodnym obciążeniom czatu jeden bazowy URL, jeden klucz API i jedno konto rozliczeń. Ułatwia to ewaluację i przełączanie modeli w Dify, zachowując widoczne wybory specyficzne dla modelu. Bezpośrednie połączenia z dostawcami mogą być nadal preferowane, gdy potrzebujesz funkcji dostępnej tylko u dostawcy, kontraktu, wdrożenia regionalnego lub ustaleń wsparcia, więc przetestuj dokładnie możliwości modelu wymagane przez Twój workflow.
Jakie modele możesz dodać do Dify?
| Rodzina | ID modelu CometAPI | Data publikacji w CometAPI (UTC) | Bieżące ceny |
|---|---|---|---|
| OpenAI | gpt-5.6 | July 9, 2026 | Zobacz bieżące ceny |
| Claude | claude-opus-5 | July 24, 2026 | Zobacz bieżące ceny |
| Gemini | gemini-3.7-flash | August 13, 2026 | Zobacz bieżące ceny |
| DeepSeek | deepseek-v4-flash | August 12, 2026 | Zobacz bieżące ceny |
Aktualne identyfikatory i daty publikacji w CometAPI powyżej zostały sprawdzone względem publicznego API katalogu dnia August 26, 2026. Używaj każdej powiązanej strony modelu CometAPI jako dynamicznego źródła cen zamiast kopiowania stawek, które mogą się zdezaktualizować. Dostępność, modalności i wsparcie wtyczki Dify również mogą się zmieniać, więc potwierdź dokładny model na swoim koncie przed wdrożeniem.
Jak podłączyć CometAPI do Dify
Krok 1 — Zainstaluj wtyczkę modelu CometAPI
Otwórz Marketplace lub sekcję Plugins w Dify i wyszukaj CometAPI. Zainstaluj wtyczkę dostawcy modeli CometAPI. Dokładne etykiety nawigacyjne mogą się różnić między Dify Cloud i wersjami self-hosted, więc użyj bieżącego ekranu konfiguracji wtyczki zamiast polegać na stałej ścieżce menu.
Krok 2 — Skonfiguruj dostawcę CometAPI
Otwórz bieżący ekran konfiguracji wtyczki CometAPI, wklej swój klucz CometAPI i zapisz poświadczenie dostawcy. Dify może je zweryfikować małym żądaniem do modelu. Wtyczka kieruje zgodne obciążenia czatu przez https://api.cometapi.com/v1, więc nie potrzebujesz oddzielnych poświadczeń do OpenAI, Anthropic, Google i DeepSeek.
Jeśli Twoje wdrożenie Dify nie może zainstalować wtyczki CometAPI, zainstaluj oficjalnego dostawcę modelu zgodnego z API OpenAI. Dodaj każdy model jako LLM w trybie Chat, użyj ponownie tego samego klucza CometAPI i ustaw API Base URL na https://api.cometapi.com/v1. Ta ścieżka zastępcza wymaga utworzenia jednego wpisu niestandardowego na model, ale nadal eliminuje potrzebę posiadania oddzielnych kont u dostawców.
Krok 3 — Dodaj cztery identyfikatory modeli
Wróć do dostawcy CometAPI i poszukaj czterech identyfikatorów na liście modeli. Jeśli jakiś identyfikator jest już predefiniowany, włącz go. Jeśli nie jest jeszcze widoczny w zainstalowanej wersji wtyczki, wybierz opcję modelu niestandardowego u tego dostawcy i wprowadź dokładny aktualny identyfikator z tabeli powyżej. Pozostaw Completion mode ustawiony na Chat.
Gdy Dify poprosi o rozmiar kontekstu dla modelu niestandardowego, użyj sprawdzonej wartości zamiast zgadywanego domyślnego. Dla przełączników multimodalnych włączaj tylko te możliwości, które są pokazane w katalogu na żywo. Model może obsługiwać Chat Completions bez obsługi obrazów, narzędzi, wyjścia strukturyzowanego lub kontroli rozumowania w taki sam sposób jak inny model.
Krok 4 — Wybierz model w swojej aplikacji Dify
Otwórz Chatflow, Workflow, Agent lub chatbota w Dify Studio. Dodaj węzeł LLM, wybierz CometAPI jako dostawcę i wybierz jeden ze skonfigurowanych identyfikatorów modeli. Użyj krótkiego promptu, np. „Odpowiedz jednym zdaniem, do której rodziny należy model”, a następnie uruchom węzeł. Powtórz dla pozostałych trzech modeli. Zmienia się tylko wybrany identyfikator modelu; poświadczenie dostawcy pozostaje to samo.
Jak przetestować połączenie w Pythonie
Użyj tego samodzielnego testu smoke, aby sprawdzić te same cztery trasy przed włączeniem Dify. Zainstaluj OpenAI Python SDK, zapisz COMETAPI_KEY w swoim środowisku i uruchom skrypt z zaufanej maszyny. Udany wynik weryfikuje klucz, endpoint i aktualne identyfikatory modeli; nie zastępuje jednak testów w rzeczywistym workflow Dify.
import osfrom openai import OpenAIMODELS = { "OpenAI": "gpt-5.6", "Claude": "claude-opus-5", "Gemini": "gemini-3.7-flash", "DeepSeek": "deepseek-v4-flash",}client = OpenAI( api_key=os.environ["COMETAPI_KEY"], base_url="https://api.cometapi.com/v1", timeout=30.0, max_retries=2,)for family, model in MODELS.items(): try: response = client.chat.completions.create( model=model, messages=[ {"role": "user", "content": "Reply with one short sentence."} ], ) text = response.choices[0].message.content or "" print(f"{family}: OK | {response.model} | {text[:80]}") except Exception as error: print(f"{family}: ERROR | {type(error).__name__} | {error}")
Trzymaj ten test poza swoim workflow Dify. Jego zadaniem jest weryfikacja klucza, endpointu i identyfikatora modelu. Gdy model przejdzie ten test, niepowodzenie w Dify najprawdopodobniej wynika z konfiguracji wtyczki, ustawień możliwości modelu lub samego workflow.
Jak zweryfikować dostępność modeli przed wdrożeniem
Możesz zweryfikować dostępność modeli przez bieżący katalog modeli CometAPI lub Models API przed wdrożeniem. Potwierdź, że dokładny identyfikator modelu pojawia się na Twoim koncie, a następnie wykonaj małe uwierzytelnione żądanie przed dodaniem go do produkcyjnego workflow w Dify.
Z własnym kluczem udane wywołanie bez strumieniowania zwraca obiekt Chat Completions. Wygenerowane sformułowanie będzie się różnić, ale odpowiedź powinna zawierać następujące pola:
{ "id": "chatcmpl-...", "object": "chat.completion", "model": "the-routed-model-id", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }}
W Dify równoważnym sygnałem powodzenia jest zakończony węzeł LLM z tekstem w panelu wyjściowym. Sprawdź logi wykonywania Dify pod kątem wybranego modelu, czasu wykonania, użycia tokenów oraz wszelkich znormalizowanych błędów dostawcy.
Jak wybrać właściwy model dla Dify
Zacznij od obciążenia, a nie nazwy dostawcy. Użyj modelu czołowego do trudnego rozumowania, pracy na dużej bazie kodu lub odpowiedzi o wysokiej wartości; wybierz szybszy model do interaktywnego czatu i powtarzalnych kroków workflow; zastosuj tańszy model tekstowy do klasyfikacji, ekstrakcji lub innych ograniczonych zadań. Porównaj modele tym samym zestawem promptów i zarejestruj jakość odpowiedzi, opóźnienie, użycie tokenów, zachowanie narzędzi i koszt na udane wykonanie. Potwierdź również, że wybrana trasa obsługuje każde wymagane wejście i funkcję. Wspólne połączenie CometAPI upraszcza przełączanie, ale nie sprawia, że limity kontekstu, wejścia multimodalne, narzędzia, wyjście strukturyzowane czy kontrola rozumowania są identyczne w różnych modelach.
Częste scenariusze i rozwiązania dotyczące rozwiązywania problemów
Dify odrzuca poświadczenie (401). Skopiuj ponownie klucz z panelu CometAPI i usuń ewentualne spacje na początku i końcu. Nie dołączaj słowa Bearer w polu API Key w Dify; wtyczka buduje nagłówek autoryzacji.
Ogólny dostawca zwraca 404 lub HTML. Użyj pełnego bazowego adresu URL https://api.cometapi.com/v1. Pominięcie /v1 lub dodanie /chat/completions do bazowego adresu URL w Dify może skutkować błędną ścieżką końcową.
Model nie pojawia się w Dify. Zaktualizuj wtyczkę CometAPI, a następnie porównaj identyfikator z katalogiem na żywo. Jeśli aktualny identyfikator nie jest predefiniowany, dodaj go jako model niestandardowy u tego samego dostawcy CometAPI. Nie zastępuj go podobnie wyglądającą nazwą modelu.
Żądanie tekstowe działa, ale obrazy lub narzędzia zawodzą. Zgodność z OpenAI opisuje powierzchnię żądania, a nie identyczne zachowanie API. Sprawdź ponownie wymienione modalności modelu oraz ustawienia wizji, wywoływania narzędzi, wyjścia strukturyzowanego i rozumowania we wtyczce.
Żądanie przekracza okno kontekstu. Potwierdź rozmiar kontekstu modelu niestandardowego w Dify, skróć pobierane dokumenty i historię rozmowy oraz zarezerwuj miejsce na wyjście. Większe okno kontekstu w katalogu nie usuwa ograniczeń workflow Dify ani specyficznych dla dostawcy zasad dotyczących tokenów.
Otrzymujesz 429 lub sporadyczne błędy 5xx. Ponawiaj błędy 429, timeout i przejściowe błędy serwera z wykładniczym backoffem i jitterem. Nie ponawiaj automatycznie błędów uwierzytelnienia, nieprawidłowego modelu lub niepoprawnego żądania.
Uwagi produkcyjne
Przechowuj sekrety po stronie serwera. Używaj oddzielnych kluczy CometAPI dla środowisk deweloperskiego i produkcyjnego, ustaw rozsądne limity, rotuj ujawnione klucze i unikaj eksportu prawdziwych poświadczeń wraz z aplikacjami Dify.
Przypnij przetestowany identyfikator modelu. Nie zastępuj po cichu modelu tylko dlatego, że w katalogu pojawiła się nowsza nazwa. Możliwości, opóźnienia, styl wyjścia i cena mogą się zmieniać między wersjami nawet przy tym samym dostawcy.
Mierz per trasa. Rejestruj identyfikator modelu, opóźnienie, użycie tokenów, kod błędu i wersję aplikacji Dify dla każdego wywołania produkcyjnego. Pozwala to porównywać modele i badać zmiany kosztów bez polegania na wrażeniach.
Projektuj fallback według możliwości. Użyj tańszego modelu do rutynowego ruchu i mocniejszego modelu do eskalacji, ale łącz tylko modele, które obsługują te same wejścia i wymagane narzędzia. Ponawiaj przejściowe błędy przed przełączeniem modelu, ogranicz całkowity budżet opóźnień i przetestuj każdą trasę fallback. Zobacz przewodnik po fallbacku modeli CometAPI dla wzorca produkcyjnego.
Sprawdź ceny przed uruchomieniem. Stawki w tym artykule to migawka z określonej daty, a nie umowa. Przejrzyj przewodnik cenowy i katalog modeli na żywo przed ustaleniem budżetu lub publikowaniem informacji o kosztach.
Najczęściej zadawane pytania
Jak dodać OpenAI do Dify poprzez CometAPI?
Zainstaluj wtyczkę dostawcy modeli CometAPI, zapisz swój klucz CometAPI i dodaj gpt-5.6 jako wybieralny model LLM. Wybierz tryb Chat, gdy Dify poprosi o tryb uzupełniania, a następnie uruchom krótki prompt tekstowy, zanim włączysz model w produkcyjnym workflow. Bieżący katalog CometAPI wymienia trasę dla zgodnych obciążeń czatu i Responses, ale wsparcie wtyczki Dify może się różnić w zależności od wersji. Jeśli identyfikator nie jest predefiniowany, zaktualizuj wtyczkę lub użyj opcji modelu niestandardowego. Pozostaw wspólne poświadczenie dostawcy bez zmian i osobno zweryfikuj wszelkie ustawienia dotyczące wejścia obrazów, wywoływania narzędzi, wyjścia strukturyzowanego i rozumowania, zanim na nich polegniesz.
Jak dodać Claude do Dify poprzez CometAPI?
W ramach tego samego połączenia dostawcy CometAPI dodaj claude-opus-5 jako oddzielny model LLM i wybierz go w węźle Dify, który potrzebuje Claude. Katalog CometAPI obecnie dokumentuje zarówno trasę Anthropic Messages, jak i trasę czatu zgodną z OpenAI dla tego modelu. Dify nadal wymaga własnego wpisu modelu, ponieważ identyfikator Claude, obsługiwane wejścia, limity tokenów i zachowanie różnią się od trasy OpenAI. Przetestuj jedną prostą odpowiedź i jedno reprezentatywne długie zadanie lub zadanie z narzędziami, a następnie sprawdź log wykonywania Dify pod kątem rzeczywistego modelu, opóźnienia, użycia tokenów i znormalizowanych błędów, zanim ustawisz go jako domyślny.
Jak dodać Gemini do Dify poprzez CometAPI?
Dodaj gemini-3.7-flash w ramach istniejącego dostawcy CometAPI, a następnie wybierz ten wpis w odpowiednim węźle LLM Dify. CometAPI obecnie wymienia zarówno natywną trasę Gemini generating-content, jak i trasę czatu zgodną z OpenAI. Dla podstawowego workflow czatu w Dify zacznij tylko od tekstu i potwierdź udane wykonanie przed testowaniem obrazów, PDF, audio lub wideo. Te modalności mogą zależeć od wersji wtyczki i konfiguracji węzła, nawet jeśli katalog modelu je wymienia. Utrzymuj Gemini jako odrębną konfigurację modelu, aby móc ustawić odpowiednie limity i porównać jego szybkość, jakość i koszt z innymi trasami.
Jak dodać DeepSeek do Dify poprzez CometAPI?
Utwórz oddzielny wpis modelu w Dify dla deepseek-v4-flash, wykorzystując to samo poświadczenie dostawcy CometAPI. Bieżący katalog CometAPI wymienia tę trasę dla obciążeń czatu tekst-tekst, więc nie kopiuj ustawień obrazów z konfiguracji OpenAI, Claude lub Gemini. Najpierw przetestuj krótki prompt tekstowy, a następnie zadanie kodowania lub rozumowania, które rzeczywiście planujesz uruchamiać. Jeśli model jest nieobecny w Dify, zaktualizuj wtyczkę lub dodaj dokładny aktualny identyfikator przez opcję modelu niestandardowego. Sprawdź ponownie stronę modelu na żywo pod kątem dynamicznego cennika i dostępności przed skierowaniem ruchu produkcyjnego.
Czy mogę używać OpenAI, Claude, Gemini i DeepSeek w tym samym workflow Dify?
Tak. Każdy węzeł LLM może używać innego dostawcy/modelu. Z CometAPI obsługiwane modele mogą współdzielić to samo poświadczenie dostawcy, podczas gdy workflow wybiera różne identyfikatory modeli.
Czy jeden klucz CometAPI naprawdę obejmuje OpenAI, Claude, Gemini i DeepSeek w Dify?
Tak. Wtyczka modelu CometAPI w Dify przechowuje jedno poświadczenie dostawcy i używa go dla obsługiwanych modeli w tych rodzinach. Nadal wybierasz lub dodajesz każdy identyfikator modelu, aby Dify wiedziało, który model wywołać.
Czy muszę wprowadzać bazowy adres URL CometAPI w Dify?
Nie, jeśli używasz dedykowanej wtyczki CometAPI; ustawia ona https://api.cometapi.com/v1 wewnętrznie. Wprowadź ten bazowy adres URL ręcznie tylko wtedy, gdy używasz ogólnego dostawcy zgodnego z API OpenAI w Dify.
Czy Dify obsługuje Claude przez API zgodne z OpenAI?
Dify może współpracować z dostawcami modeli zgodnych z OpenAI, ale zgodność nie czyni zachowania API Claude identycznym z OpenAI. Zweryfikuj obsługiwane parametry i możliwości modelu przed włączeniem narzędzi, wyjścia strukturyzowanego, wizji lub funkcji specyficznych dla rozumowania.
Czy mogę używać tych samych ustawień Dify dla każdego modelu?
Nie. Endpoint i klucz mogą być współdzielone, ale limity kontekstu, modalności, wsparcie narzędzi, kontrola rozumowania, opóźnienia i ceny pozostają specyficzne dla modelu. Traktuj każde mapowanie modelu jako przetestowaną konfigurację.
Jaki model powinien być domyślny?
Wybierz po przetestowaniu własnych promptów. Niskokosztowy model może obsłużyć rutynową klasyfikację lub przepisywanie, podczas gdy mocniejszy model poradzi sobie ze złożonym rozumowaniem lub odpowiedziami o wyższej wartości. Unikaj uniwersalnego „najlepszego” wyboru bez danych z obciążenia.
Wnioski
CometAPI pozwala workspace Dify używać OpenAI, Claude, Gemini i DeepSeek przez jedno poświadczenie dostawcy i jeden ujednolicony endpoint API dla zgodnych obciążeń czatu. Konfiguracja jest krótka: zainstaluj wtyczkę modelu, zapisz klucz, zmapuj aktualne identyfikatory modeli i przetestuj każdą trasę. Praca operacyjna pozostaje jednak specyficzna dla modelu — możliwości, kontekst, ceny i zachowanie fallback należy weryfikować, a nie zakładać.