시작하기
앱에서 사용하기
코드를 작성하지 않고도 이미 사용 중인 앱에서 키를 쓸 수 있습니다. 앱을 고르고 설정을 복사하면 끝입니다. 이 단계는 GPT 모델용입니다.
#1. 앱 선택
채팅 및 번역 앱
코딩 도구
직접 작성한 코드
#2. 설정 복사
Cherry Studio
위치: Settings (设置) → Model Providers (模型服务) → OpenAI
"API Host"는 /v1/chat/completions를 자동으로 붙입니다. URL은 호스트(또는 /v1)까지만 입력하고, 자동 추가를 끄려면 끝에 #을 붙이세요.
API 키를 비공개로 유지하세요
키는 환경 변수나 시크릿 관리자에 저장하세요. 영구 키를 브라우저 코드, 스크린샷, 저장소에 절대 붙여 넣지 마세요.
#3. 동작 확인
- 앱에서 모델을 선택하고 “안녕” 같은 짧은 메시지를 보내세요.
- 답장이 오면 연결된 것입니다. 이 호출은 콘솔 → 사용량에 표시됩니다.
- 앱이 키를 거부하면, 주소에 /v1을 붙여야 하는지 확인하세요.
#MCP 도구
모델 연결과 MCP는 별개
aisplice는 모델 연결을, MCP 서버는 외부 도구와 데이터를 제공합니다. Codex, Cursor 등 사용하는 클라이언트에서 aisplice 제공업체와 각 MCP 서버를 따로 설정하세요.
Codex에서는 CLI로 원격 MCP 서버를 추가하거나, 같은 내용의 블록을 ~/.codex/config.toml에 넣으세요:
Codex MCP
# CLI
codex mcp add my-tools --url https://mcp.example.com/mcp
# equivalent ~/.codex/config.toml
[mcp_servers.my-tools]
url = "https://mcp.example.com/mcp"MCP 인증은 별도
aisplice API 키는 모델 요청 인증에만 사용됩니다. OAuth, 헤더, 환경 변수는 MCP 서버 제공업체의 안내를 따르고, 설정을 다시 불러오도록 클라이언트를 재시작하세요.
#OpenAI SDK에서 옮겨 오기
#두 줄짜리 diff
대부분의 코드베이스에서는 이것이 PR의 전부입니다. 전송 형식이 OpenAI 호환이므로 스트리밍, 도구 호출, 비전, 구조화된 출력이 기존 코드 그대로 계속 동작합니다.
const client = new OpenAI({- baseURL: "https://api.openai.com/v1",+ baseURL: "https://www.aisplice.store/v1",- apiKey: process.env.OPENAI_API_KEY,+ apiKey: process.env.GATEWAY_API_KEY,});
아직 해결되지 않았나요?
요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.