OpenHands
OpenHands는 환경변수(OPENAI_API_BASE) 또는 웹 UI(Settings > LLM > Advanced Settings)에서 Base URL과 openai/ 접두사를 설정합니다.
설정 예시입니다. OpenHands 버전에 따라 메뉴·설정 이름이 조금 다를 수 있습니다.
공통 환경변수는 코딩 에이전트 연결의
#setup을 보세요.설정#
환경변수를 설정하거나 OpenHands UI(Settings > LLM)에서 API Key에 plm_ 키, Advanced Settings의 Base URL에 https://apirouter.pleum.ai/v1, 모델에 openai/<model-id>를 지정합니다.
environment
export OPENAI_API_BASE=https://apirouter.pleum.ai/v1
export OPENAI_API_KEY=plm_xxxxxxxxxxxxxxxx
# prefix the model id with openai/
# model = openai/gpt-5.5
# Or in OpenHands Web UI:
# Settings -> LLM
# LLM Provider : openai
# LLM Model : openai/gpt-5.5
# API Key : plm_xxxxxxxxxxxxxxxx
# Advanced Settings -> Base URL : https://apirouter.pleum.ai/v1확인#
짧은 프롬프트를 보내 응답이 오면 연결입니다. 비용은 응답 헤더 X-Request-Id로 GET /v1/generation?id=…에서 조회할 수 있습니다.
작동 방식#
이 도구는 OpenAI Chat Completions 형식(/v1/chat/completions)으로 요청합니다. base URL은 https://apirouter.pleum.ai/v1이고 인증은 plm_ 키를 Authorization: Bearer로 보냅니다.
오류#
스니펫의 plm_xxxxxxxxxxxxxxxx는 더미입니다. 대시보드 API 키에서 발급한 실제 키로 바꾸세요. Base URL 끝에 /chat/completions를 붙이지 마세요.
| 증상 | 원인과 조치 |
|---|---|
| 401 Unauthorized | 키가 틀렸거나 비활성입니다. 대시보드 API 키에서 plm_ 키를 다시 복사하세요. 다른 서비스의 키를 넣지 않았는지도 확인하세요. |
| 402 Payment Required | 크레딧 잔액이 부족하거나 키의 일·주·월 예산이나 월 토큰 한도를 다 썼습니다. 충전하거나 API 키의 예산과 한도를 확인하세요. |
| 404 Not Found | base URL이 틀렸거나 모델 ID가 카탈로그에 없습니다. OpenAI 호환 도구는 /v1까지, Anthropic·Gemini 도구는 /v1이 없는 루트 주소입니다. 끝에 /chat/completions 같은 경로를 직접 붙이지 마세요. 오류 코드가 model_not_found면 모델 ID를 확인하세요. |
| 429 Too Many Requests | 키당 분당 요청 한도나 동시 요청 한도(concurrency_limit_exceeded)를 넘었거나, 모델 공급자 쪽 한도에 걸렸습니다(upstream_rate_limited). 에이전트의 병렬 실행 수를 줄이고 사용량 제한을 확인하세요. |
| model not found | 카탈로그에 없는 모델 ID입니다. GET /v1/models로 정확한 ID를 확인하고 대소문자까지 그대로 쓰세요. |