n8n·Dify AI 연결하기 — OpenAI 호환 주소·키·모델 설정

원포트 AI 는 OpenAI 와 같은 모양의 API 를 https://oneport.kr/v1 에서 받아요. n8n 과 Dify 는 OpenAI 주소를 바꿔 넣는 칸이 있어서, 그 칸에 이 주소와 원포트 AI 키를 넣으면 돼요.

아래 칸 이름은 n8n·Dify 문서와 소스를 2026년 10월 17일에 확인해 옮겼어요. 버전에 따라 이름이 조금 다를 수 있어요.

키는 크레딧이 들어 있는 지갑에서 만들어요. 스쿨오더·오피스오더에서 샀다면 그곳 「AI API」 화면의 「키 만들기」, 원포트 스페이스라면 그룹의 「새 키 만들기」를 눌러요. 「쓰임새」 칸이 보이면 이 도구에 맞게 골라요.

키 원문은 만들 때 한 번만 보여요. n8n·Dify 에 넣기 전에 안전한 곳에 적어 두세요.

스쿨오더·오피스오더 「AI API」 화면에서는 n8n 용과 Dify 용 키를 따로 만들면 키 줄마다 「이번 달 사용 / 한도」가 갈려서 어느 도구가 얼마 썼는지 보여요. 원포트 스페이스 키는 그 키가 붙은 그룹의 상한 안에서 써요.

고른 모델이 채팅 모델인지는 /v1/models 의 kind 칸에서 봐요.

1. 1OpenAI Chat Model 노드(또는 AI Agent 에 붙이는 Chat Model)를 열고, 자격 증명 칸에서 새 OpenAI 자격 증명을 만들어요.
2. 2「API Key」에 원포트 AI 키를, 「Base URL」에 https://oneport.kr/v1 을 넣고 저장해요. 「Organization ID」는 비워 둬요. 저장할 때 연결 확인이 성공해도 키가 맞다는 뜻은 아니에요. 첫 호출에서 401 이 오면 키를 다시 붙여 넣어요.
3. 3노드의 「Model」에서 「From List」를 열면 모델 목록이 떠요. 그림·임베딩 모델도 같이 보이니, 채팅 노드에는 채팅 모델을 골라요. 목록 대신 「ID」를 골라 모델 id 를 그대로 적어도 돼요.
4. 4Claude·Gemini 모델을 쓰면 「Use Responses API」를 꺼요. 새 노드는 이 토글이 켜진 채로 생기고, 원포트 AI 의 Responses 문은 OpenAI 모델만 받아요. /v1/models 에서 kind 가 responses 인 모델(gpt-5.5-pro 등)은 Responses 로만 불려서 이 토글을 켜 둬요.
5. 5검색용 임베딩이 필요하면 같은 자격 증명으로 Embeddings OpenAI 노드를 붙이고 text-embedding-3-small 같은 임베딩 모델을 골라요.

1. 1「Integrations」 > 「Model Provider」에서 「OpenAI-API-compatible」을 설치해요. 공급자는 워크스페이스 소유자나 관리자만 손댈 수 있어요.
2. 2공급자 카드의 「Add Model」을 눌러 모델 종류를 LLM 으로 두고, 「Model Name」에 모델 id 를 그대로 적어요.
3. 3「API Key」에 원포트 AI 키를, 「API Base URL」에 https://oneport.kr/v1 을 넣어요. 「Completion mode」는 Chat 그대로 둬요.
4. 4「API Type」은 Chat Completions API 그대로 둬요. /v1/models 에서 kind 가 responses 인 모델(gpt-5.5-pro 등)만 Responses API 로 바꿔요.
5. 5「Model context size」는 기본값이 4096 이에요. 그 모델이 받는 길이에 맞게 /v1/models 의 context_window 값을 넣어요.
6. 6도구를 쓰는 에이전트라면 「Function Call Type」을 Tool Call 로 바꿔요. Claude 모델로 갈 때도 원포트 AI 가 함수 도구를 바꿔 넘기고 결과를 tool_calls 로 돌려줘요.
7. 7쓸 모델마다 「Add Model」을 되풀이해요. 임베딩 모델도 모델 종류만 text-embedding 으로 바꾸고 같은 키와 주소를 넣어요.

원포트 AI 는 고른 모델을 다른 모델로 바꿔 답하지 않아요(이용약관 제37조⑥). 같은 모델을 다른 연결로 다시 시도할 수는 있어요.

그래서 「실패하면 다른 모델로」는 n8n·Dify 에서 직접 정해요. 예비 모델로 넘어간 답은 그 예비 모델의 차감 단가대로 크레딧을 사용해요.