Agent 통합 가이드
Gemini CLI를 WaveSpeed LLM API와 함께 사용
이 가이드는 ~/.gemini/.env, Gemini generateContent API, /v1beta/models/{model}:generateContent, base URL https://llm.wavespeed.ai/v1, 기본 모델 deepseek/deepseek-v4.1-flash-1017로 Gemini CLI를 WaveSpeed AI에 연결하는 방법을 보여줍니다. 위 설정을 복사하고 API 키를 export한 뒤 agent를 실행하고 Logs에서 요청을 확인하세요.
WaveSpeed 액세스 키 만들기
필요한 키를 로컬에서 export
설정을 붙여넣을 파일
~/.gemini/.envgemini 실행 후 Logs 확인
이 Gemini CLI 설정이 구성하는 항목
프로토콜
Gemini generateContent API
Endpoint
/v1beta/models/{model}:generateContent
모델
deepseek/deepseek-v4.1-flash-1017
위의 복사 가능한 설정은 권장 setup에서 수정해야 하는 유일한 Gemini CLI 파일입니다: ~/.gemini/.env. API 키가 repository에 커밋되지 않도록 shell 환경에 보관하세요.
문제 해결
API 키가 인식되지 않습니다
Gemini CLI를 실행하는 같은 shell에서 WAVESPEED_API_KEY를 export하세요. shell profile을 사용한다면 agent를 시작하기 전에 terminal을 다시 로드하세요.
프로토콜 또는 endpoint 오류로 요청이 실패합니다
Gemini CLI가 Gemini generateContent API 및 endpoint /v1beta/models/{model}:generateContent를 사용하는지 확인하세요. 프로토콜 불일치는 404 또는 payload 오류의 가장 흔한 원인입니다.
선택한 모델이 작동하지 않습니다
모델 ID가 WaveSpeed Models에 존재하는지 확인한 뒤 정확한 ID를 ~/.gemini/.env에 붙여넣으세요. 이 페이지에 표시된 기본 모델로 시작할 수 있습니다.
Logs에 요청이 표시되지 않습니다
Gemini CLI가 WaveSpeed base URL과 현재 API 키를 사용하는지 확인하세요. 그런 다음 로컬 agent에서 새 prompt를 보내고 Logs를 새로고침하세요.
이 Gemini CLI 가이드가 검색에 표시될 수 있나요?
네. 이 페이지는 Gemini CLI custom provider, OpenAI 호환 endpoint, base URL, 로컬 agent 설정 workflow를 검색하는 사용자를 위한 indexable 설정 가이드로 만들어졌습니다.