설정할 내용
openwebui n8n 채팅 방법을 입력하여 여기에 도착했다면, 두 가지 관련 작업을 수행하려고 할 것입니다: Open WebUI에서 모델과 대화하고 n8n 워크플로우에서 해당 모델을 호출하기. 두 도구 모두 OpenAI 채팅 완성 형식을 따르는 서버를 가리킬 수 있으므로 하나의 계정이 둘 다를 커버합니다.
Open WebUI는 자체 호스팅 채팅 인터페이스입니다. n8n은 노드를 함께 연결하는 워크플로우 자동화 도구입니다. 그 뒤의 API는 각 경우 동일합니다:
- Base URL:
https://api.nofilteraichat.com/v1 - 모델 ID:
uncensored - 인증: 키를 운반하는
Authorization: Bearer헤더
먼저 키가 필요합니다. API 키 페이지에서는 가입 절차와 원클릭 $0.50 체험 크레딧 발급 과정을 단계별로 안내합니다. 아래 모든 기능을 테스트하기에 충분한 금액입니다.
파트 1: Open WebUI
옵션 A: 관리자 패널
Open WebUI가 이미 실행 중이라면 관리자로 로그인하고 관리자 설정, 연결을 엽니다. 다음 값으로 새 OpenAI API 연결을 추가하십시오:
- URL:
https://api.nofilteraichat.com/v1 - 키: API 키
- 저장한 후, 사용 중인 버전에서 검증 버튼이 있다면 이를 사용하세요.
릴리스마다 메뉴 이름이 약간씩 달라질 수 있으므로, OpenAI 스타일 연결을 나열한 섹션을 찾아보세요. 저장한 후 새 채팅을 시작하고 모델 선택기를 엽니다. 모델 uncensored가 표시되어야 합니다. 이는 Open WebUI가 GET /v1/models 엔드포인트에서 모델 목록을 로드하기 때문입니다.
옵션 B: Docker의 환경 변수
새로 시작하는 경우 컨테이너를 시작할 때 설정을 전달하십시오:
docker run -d --name open-webui -p 3000:8080 \
-e OPENAI_API_BASE_URL="https://api.nofilteraichat.com/v1" \
-e OPENAI_API_KEY="$NOFILTER_API_KEY" \
-v open-webui:/app/backend/data \
ghcr.io/open-webui/open-webui:mainhttp://localhost:3000을 열고 첫 로컬 계정을 생성하세요. 선택기에서 모델이 이미 준비되어 있습니다. Open WebUI는 첫 실행 후 연결 설정을 데이터베이스에 저장합니다. 나중에 변수를 변경했는데도 아무 변화가 없다면, 관리자 패널에서 연결을 직접 수정하세요.
채팅 조정
채팅 컨트롤에서 temperature, top_p, 중단 시퀀스 및 시스템 프롬프트를 설정할 수 있습니다. 이러한 설정은 모델에 전달됩니다. 픽션이나 롤플레이의 경우 temperature를 0.7~1.0으로 설정하면 더 생동감 있는 문체가 나옵니다. 사실 기반 질문에는 더 낮은 값을 사용하세요. 모델이 구문을 반복하기 시작하면 frequency penalty를 약간 높여주세요.
파트 2: OpenAI 노드가 있는 n8n
n8n에는 내장 OpenAI 자격 증명이 있습니다. 구성에는 Base URL 필드가 포함되어 있으며, 기본값은 공식 서버입니다. 이 값을 변경하면 노드가 다음 엔드포인트로 통신합니다:
- n8n에서 OpenAI 유형의 새 자격 증명을 만듭니다.
- API 키를 붙여넣습니다.
- Base URL을
https://api.nofilteraichat.com/v1로 설정합니다. - 저장하고 자격 증명을 OpenAI Chat Model 노드 또는 AI Agent 워크플로우에 연결합니다.
핵심은 모델 필드입니다. 일부 노드는 모델 목록에서 채워진 드롭다운을 표시하고, 일부는 알려진 이름으로 선택지를 제한합니다. uncensored를 선택할 수 없다면 필드를 수식 모드로 전환하고 ID를 직접 입력하세요. n8n 버전에서 여전히 거부하면, 다음 섹션의 HTTP Request 방식을 사용하세요. 이 방식에는 그런 제한이 없습니다.
자격 증명이 작동하면 채팅 모델을 AI Agent 노드에 연결하고 도구를 제공할 수 있습니다. API는 함수 호출을 지원합니다(tools, tool_choice, 그리고 role: "tool" 형식의 결과). 모든 오픈 웨이트 모델과 마찬가지로 실제 입력에서 에이전트를 테스트하고 도구 설명을 짧고 문자 그대로 작성하세요.
파트 3: HTTP Request 노드로 채팅하기
가장 예측 가능한 옵션은 일반 HTTP 요청 노드입니다. 전송되는 내용을 정확히 보여주며 모든 n8n 버전에서 작동합니다. 노드를 다음과 같이 구성하세요:
- 메서드: POST
- URL:
https://api.nofilteraichat.com/v1/chat/completions - 인증: 헤더 인증, 이름
Authorization, 값Bearer YOUR_KEY(노드에 직접 입력하지 말고 자격 증명으로 저장하세요) - 본문 보내기: 켜짐, 콘텐츠 유형 JSON
사용자 텍스트에 표현식을 사용하여 본문을 다음으로 설정하십시오:
{
"model": "uncensored",
"messages": [
{ "role": "system", "content": "You are a concise story assistant for adult fiction writers." },
{ "role": "user", "content": "{{ $json.prompt }}" }
],
"temperature": 0.8,
"max_tokens": 600
}응답 텍스트는 choices[0].message.content에 있습니다. 다음 노드에서는 표현식 {{ $json.choices[0].message.content }}로 읽으십시오. 동일한 응답에는 usage 블록도 포함되어 있으므로 시트나 데이터베이스에 토큰 수를 기록할 수 있습니다.
일반적인 워크플로는 웹훅 트리거, 이 HTTP 노드, 텍스트를 반환하는 응답 노드로 구성됩니다. 또 다른 일반적인 예는 스프레드시트에서 행을 읽고 각 행에 대해 초안을 생성한 후 결과를 다시 작성하는 것입니다. curl을 사용하여 n8n 외부에서 요청을 먼저 테스트할 수도 있습니다:
curl https://api.nofilteraichat.com/v1/chat/completions \
-H "Authorization: Bearer $NOFILTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'n8n의 제한, 재시도 및 배치
풀 키는 동시 8개 요청과 분당 300개 요청을 허용하며, 체험 키는 동시 2개와 분당 60개를 허용합니다. n8n은 노드가 모든 입력 항목을 처리하고 빠르게 트리거하므로 이러한 한계치를 쉽게 초과할 수 있습니다.
HTTP Request 노드에서 옵션을 열고 배치 처리를 사용하십시오: 배치 크기를 4 또는 6으로, 간격을 1초 또는 2초로 설정합니다. 노드 설정에서 실패 시 재시도를 3회 시도, 대기 시간 5000ms로 활성화하십시오. 이는 API 동작과 일치합니다: API가 잠시 과부하 상태이면 HTTP 429를 Retry-After: 5 헤더와 함께 반환합니다. 다른 429 코드는 어떤 제한에 도달했는지 알려줍니다: rate_limited은 분당 요청이 너무 많음을 의미하고, concurrency은 동시 요청이 너무 많음을 의미합니다.
스트리밍에 대한 참고 사항입니다. 스트리밍된 요청은 스트림이 끝날 때까지 동시 요청 슬롯을 유지합니다. n8n에서는 워크플로우가 전체 답변을 기다리므로 HTTP 노드에서 스트리밍을 끄십시오. Open WebUI는 기본적으로 스트리밍되는데, 이는 채팅 창에 적합합니다.
워크플로우 비용
워크플로우가 500개의 행을 처리하여 각 행당 800개의 입력 토큰을 보내고 250개의 출력 토큰을 받는다고 가정해 봅시다. 입력: 500 × 800 = 400,000 토큰, 비용은 400,000 × $0.15 / 1,000,000 = $0.06입니다. 출력: 500 × 250 = 125,000 토큰, 비용은 125,000 × $0.50 / 1,000,000 = $0.0625입니다. 실행 총 비용은 $0.1225로 약 12센트입니다. 충전을 위해서는 가격 책정 페이지를 참조하세요.
문제 해결
| 증상 | 잠재적 원인 | 해결 방법 |
|---|---|---|
| Open WebUI에 모델이 표시되지 않음 | 잘못된 URL 또는 키 | /v1로 끝나는 base URL을 사용합니다. curl로 GET /v1/models를 테스트합니다. |
| Docker 환경 변수 변경 무시됨 | 설정이 이미 저장됨 | 관리자 설정에서 연결 편집 |
| n8n에서 401 오류 | 헤더 값에서 Bearer 단어 누락 | 값은 Bearer, 공백, 그 다음 키로 구성되어야 합니다 |
| Docker의 Open WebUI에서 로컬 프록시에 연결할 수 없음 | localhost가 컨테이너를 가리킴 | localhost 대신 호스트 주소를 사용하세요 |
| 루프 중간에 429 오류 발생 | 동시 요청 항목이 너무 많음 | HTTP 노드를 배치 처리하고 재시도를 활성화하세요 |
| 모델을 찾을 수 없음 | 이름을 잘못 입력함 | 사용 가능한 유일한 모델 ID는 uncensored입니다 |
플로우를 설계할 때 제품 제한을 기억하세요: 텍스트 채팅 전용, 프롬프트와 응답이 공유하는 100,000 토큰 컨텍스트 창, 8 MB 요청 본문. 임베딩 엔드포인트가 없으므로 벡터 검색은 다른 서비스에서 유지하세요. 빠른 시작에는 전체 요청 참조가 포함되어 있으며, 연동 가이드에는 더 많은 프론트엔드를 다룹니다. API를 통해 전송된 프롬프트는 학습에 사용되지 않습니다.
이 규칙은 모든 도구에서 적용됩니다: 미성년자가 관련된 성적인 콘텐츠는 금지됩니다. 합법적인 성인 사용 범위 내에서 모델은 콘텐츠 거부 없이 답변하도록 조정되어 있어 소설, 롤플레이 및 성인용 컴패니언 앱에 적합합니다.
