Storm OpenAPI
  1. 에러 코드 가이드
Storm OpenAPI
  • Welcome to STORM
    • STORM 소개
  • Quickstart
    • 시작하기
      • 계정 생성
      • 에이전트 생성
    • 주요 활용 시나리오
      • 문서 업로드
      • 워크플로우 설계
      • 테스트
      • 배포
      • 채널 연동
  • Feature Guide
    • 콘솔
      • 에이전트 관리
      • 대시보드
      • 권한 설정
    • 에이전트 템플릿
      • 지식 탐색
      • 캐릭터 대화
      • 상담기록 분석
      • 기사 작성
      • SQL문 작성
      • 보고서 작성
      • CS 챗봇
    • 에이전트 빌더
      • 지식
        • 문서
        • 폴더
        • 피드백
      • 워크플로우
        • 노드 설명
          • LLM
          • 검색(RAG)
          • API
          • IF ELSE
          • 변수 선언과 할당
          • 후처리
      • 테스트
      • 로그
      • 대시보드
    • 관리자 도구
      • 배포 관리
      • 채널 연동
      • 모델 파인튜닝
      • 학습 데이터 품질 관리
      • 기타 설정
      • Teams 채널 연동
  • Apis
    • 에이전트
      • 에이전트 조회
      • 에이전트 배포
      • 에이전트 배포 이력 조회
    • 버킷
      • 버킷 생성
      • 버킷 조회
    • 문서
      • 문서 학습 요청 by file
      • 문서 학습 요청 by url
      • 문서 조회
      • 문서 삭제
    • 채팅
      • 채팅 중 파일 업로드
        • 파일 생성 및 Presigned URL 발급
        • 파일 업로드 완료 처리
        • 파일 상태 조회
      • 채팅 전송 (OpenAI 호환)
      • 채팅 전송 (non-stream)
      • 채팅 전송 (stream)
      • 컨텍스트 검색
    • STORM Parse
      • /convert/md
  • Learn More
    • 자주 묻는 질문
    • 과금 플랜
    • 에러 코드 가이드
      • ApiCall
      • IfElse
      • Variable
      • Response
      • Function
      • OpenLLM
      • Post
      • Rag
      • Loop
  • Schemas
    • Response
      • CheckedException
    • [common] status
    • [object] document
    • [object] chat
    • [object] agent
    • [object] deployment
    • [object] chat stream chunk
    • [object] context
    • [object] user
    • [object] bucket
    • message
    • [res] pageinfo
  1. 에러 코드 가이드

OpenLLM

OpenLLM 노드 에러#

LLM(Large Language Model)을 호출하는 노드에서 발생할 수 있는 에러입니다.

유효성 검사 에러#

OPENLLM_MISSING_PROMPT#

설명
프롬프트가 누락되었습니다. OpenLLM 노드의 prompt 속성이 null이거나 빈 값인 경우 발생합니다.
해결 방법
OpenLLM 노드의 prompt 속성에 LLM에 전달할 프롬프트를 설정해주세요.

OPENLLM_INVALID_MODEL#

설명
유효하지 않은 모델이 지정되었습니다. 지원되지 않는 모델명이 설정된 경우 발생합니다.
해결 방법
지원되는 모델 중 하나를 선택해주세요.

OPENLLM_UNSUPPORTED_LANGUAGE#

설명
지원하지 않는 언어가 지정되었습니다.
해결 방법
지원되는 언어 코드를 사용해주세요.

네트워크 에러#

OPENLLM_CONNECTION_FAILED#

설명
LLM 서버에 연결할 수 없습니다. 네트워크 오류가 발생한 경우입니다.
해결 방법
LLM 서버의 상태를 확인해주세요.
네트워크 연결 상태를 점검해주세요.

OPENLLM_DNS_FAILURE#

설명
LLM 서버의 도메인 이름을 확인할 수 없습니다. 도메인 해석에 실패한 경우 발생합니다.
해결 방법
LLM 서버 URL이 올바른지 확인해주세요.
DNS 서버 설정을 점검해주세요.

OPENLLM_CONNECTION_REFUSED#

설명
LLM 서버가 연결을 거부했습니다.
해결 방법
LLM 서버가 정상적으로 실행 중인지 확인해주세요.
서버 URL과 포트가 올바른지 확인해주세요.

OPENLLM_CONNECTION_TIMEOUT#

설명
LLM 서버에 연결하는 데 시간이 너무 오래 걸렸습니다.
해결 방법
LLM 서버의 상태를 확인해주세요.
네트워크 연결 상태를 점검해주세요.

OPENLLM_READ_TIMEOUT#

설명
LLM 서버로부터 응답을 받는 데 시간이 너무 오래 걸렸습니다.
해결 방법
프롬프트의 길이를 줄여주세요.
최대 토큰 수 설정을 조정해주세요.

OPENLLM_WRITE_TIMEOUT#

설명
LLM 서버로 요청을 보내는 데 시간이 너무 오래 걸렸습니다.
해결 방법
네트워크 상태를 점검해주세요.
요청 데이터의 크기를 확인해주세요.

OPENLLM_SSL_ERROR#

설명
LLM 서버와의 SSL/TLS 연결에 실패했습니다.
해결 방법
LLM 서버의 SSL 인증서가 유효한지 확인해주세요.
URL의 프로토콜이 올바른지 확인해주세요.

OPENLLM_CONNECTION_ERROR#

설명
LLM 서버 연결에 실패했습니다. 기타 연결 오류가 발생한 경우입니다.
해결 방법
LLM 서버의 상태를 확인해주세요.
네트워크 연결 상태를 점검해주세요.

OPENLLM_TIMEOUT#

설명
LLM 응답 시간이 초과되었습니다. 응답 지연이 발생한 경우입니다.
해결 방법
프롬프트의 길이를 줄여주세요.
필요한 경우 타임아웃 설정을 조정해주세요.

OPENLLM_STREAMING_ERROR#

설명
스트리밍 응답을 처리하는 중 오류가 발생했습니다. 스트리밍 수신 또는 처리에 실패한 경우입니다.
해결 방법
네트워크 연결이 안정적인지 확인해주세요.
잠시 후 다시 시도해주세요.

HTTP 상태 에러#

OPENLLM_HTTP_400#

설명
잘못된 요청입니다 (400 Bad Request). 요청 형식이 올바르지 않거나 파라미터가 유효하지 않은 경우 발생합니다.
해결 방법
요청 파라미터가 LLM API 명세와 일치하는지 확인해주세요.
프롬프트 형식이 올바른지 확인해주세요.

OPENLLM_HTTP_401#

설명
인증에 실패했습니다 (401 Unauthorized). API 키가 유효하지 않거나 누락된 경우 발생합니다.
해결 방법
API 키가 올바르게 설정되어 있는지 확인해주세요.
API 키가 만료되지 않았는지 확인해주세요.

OPENLLM_HTTP_403#

설명
접근이 거부되었습니다 (403 Forbidden). API 키에 해당 모델에 대한 접근 권한이 없는 경우 발생합니다.
해결 방법
API 키의 권한을 확인해주세요.
사용하려는 모델에 대한 접근 권한이 있는지 확인해주세요.

OPENLLM_HTTP_404#

설명
리소스를 찾을 수 없습니다 (404 Not Found). 요청한 모델이 존재하지 않는 경우 발생합니다.
해결 방법
모델 이름이 올바른지 확인해주세요.
해당 모델이 사용 가능한지 확인해주세요.

OPENLLM_HTTP_429#

설명
요청 횟수가 너무 많습니다 (429 Too Many Requests). API 호출 제한을 초과한 경우 발생합니다.
해결 방법
잠시 후 다시 시도해주세요.
API 호출 빈도를 줄여주세요.
필요한 경우 rate limit 상향을 요청해주세요.

OPENLLM_HTTP_500#

설명
서버 내부 오류입니다 (500 Internal Server Error).
해결 방법
잠시 후 다시 시도해주세요.
문제가 지속되면 LLM 서비스 제공자에게 문의해주세요.

OPENLLM_HTTP_502#

설명
게이트웨이 오류입니다 (502 Bad Gateway).
해결 방법
잠시 후 다시 시도해주세요.
LLM 서버의 상태를 확인해주세요.

OPENLLM_HTTP_503#

설명
서비스를 사용할 수 없습니다 (503 Service Unavailable). LLM 서버가 점검 중이거나 과부하 상태인 경우 발생합니다.
해결 방법
잠시 후 다시 시도해주세요.
LLM 서비스의 상태 페이지를 확인해주세요.

OPENLLM_HTTP_504#

설명
게이트웨이 시간 초과입니다 (504 Gateway Timeout).
해결 방법
잠시 후 다시 시도해주세요.
프롬프트 길이를 줄여 처리 시간을 단축해주세요.

OPENLLM_HTTP_CLIENT_ERROR#

설명
클라이언트 오류가 발생했습니다 (4xx). 일반적인 4xx 상태 코드 fallback입니다.
해결 방법
응답 상세 내용을 확인하여 구체적인 원인을 파악해주세요.
요청 형식과 파라미터를 점검해주세요.

OPENLLM_HTTP_SERVER_ERROR#

설명
서버 오류가 발생했습니다 (5xx). 일반적인 5xx 상태 코드 fallback입니다.
해결 방법
잠시 후 다시 시도해주세요.
문제가 지속되면 LLM 서비스 제공자에게 문의해주세요.

처리 에러#

OPENLLM_TOKEN_LIMIT_EXCEEDED#

설명
토큰 제한을 초과했습니다. 입력 프롬프트와 예상 출력의 총 토큰 수가 모델의 최대 한도를 초과한 경우 발생합니다.
해결 방법
입력 프롬프트의 길이를 줄여주세요.
최대 출력 토큰 수(max_tokens) 설정을 낮춰주세요.
더 큰 컨텍스트를 지원하는 모델을 사용해주세요.

OPENLLM_INVALID_RESPONSE#

설명
LLM 서버의 응답 형식이 유효하지 않습니다. 응답 구조 또는 파싱에 문제가 있는 경우 발생합니다.
해결 방법
LLM 서버가 정상적으로 동작하는지 확인해주세요.
잠시 후 다시 시도해주세요.

OPENLLM_UNKNOWN_ERROR#

설명
알 수 없는 LLM 오류가 발생했습니다. 분류되지 않은 기타 에러입니다.
해결 방법
에러 상세 메시지를 확인하여 구체적인 원인을 파악해주세요.
문제가 지속되면 관리자에게 문의해주세요.

일반 에러#

모든 노드에서 공통적으로 발생할 수 있는 일반적인 에러입니다.

EXECUTOR_UNKNOWN_ERROR#

설명
알 수 없는 실행 오류가 발생했습니다. 모든 노드의 fallback 에러로, 분류되지 않은 예외 상황입니다.
해결 방법
에러 상세 메시지를 확인하여 구체적인 원인을 파악해주세요.
워크플로우 설정을 점검해주세요.
문제가 지속되면 관리자에게 문의해주세요.
Modified at 2026-03-12 07:35:42
Previous
Function
Next
Post
Built with