Antigravity 사용 가능 모델을 Cherry Studio에 연결하세요.

Windows를 예로 들어 먼저 생성 방지 도구와 Cherry Studio를 설치합니다. 정상적으로 사용할 수 있는 소프트웨어가 이미 있는 경우 바로 계속할 수 있습니다.

1. 원래 프로젝트 주소 확인

   아래 Draculabo/AntigravityManager 프로젝트를 열고 Releases를 입력하세요. 소프트웨어 이름이나 Star 수량 또는 이전 스크린샷의 버전 번호만으로 다운로드 사이트를 검색하지 마십시오.

2. 시스템 및 프로세서 아키텍처 선택

   Windows의 경우 x64 또는 ARM64에 해당하는 .exe 설치 패키지를 선택합니다. 릴리스 지침에 따라 MSI를 선택할 수도 있습니다. macOS 및 Linux의 경우 해당 플랫폼 패키지를 선택하세요. Source code를 설치 패키지로 다운로드하지 마십시오. 그림의 0.20.0는 역사적인 예입니다.

3. 설치 및 열기

   설치 마법사를 따라 설치를 완료하고 필요에 따라 디스크를 선택할 수 있습니다. 경로 호환성 문제를 줄이려면 원본 게시물과 같은 짧은 영어 디렉터리를 사용하세요. 개봉 후 대시보드에 들어갈 수 있는지 확인하세요.

4. 준비 Cherry Studio

   아직 클라이언트가 없다면 Cherry Studio 공식 프로젝트에서 해당 시스템 설치 패키지를 다운로드하세요. 이 기사의 후반부에서는 이를 데모용으로 사용합니다. 먼저 두 소프트웨어를 모두 준비합니다.

请从 https://github.com/Draculabo/AntigravityManager/releases/latest 下载并安装适合本机系统与架构的 Antigravity Manager。先核对发布来源与安装目录，保留已有账号配置；若发布页提供 SHA256，则核对校验值。安装后确认程序能启动，然后停止，把账号登录、OAuth 授权和启动服务交给我自己操作。

자신의 브라우저에서 로그인 및 확인을 완료하세요. 승인이 성공적으로 완료되면 도구로 돌아가서 계정 상태를 확인해야 합니다.

1. 먼저 해당 계정에 정상적으로 접속이 가능한지 확인하세요.

   자신의 브라우저를 사용하여 Google에 로그인하고 계정이 Antigravity 관련 서비스를 사용할 수 있는지 확인하세요. 공식 페이지에서 최초 설정이나 인증이 필요한 경우 먼저 공식 페이지에서 완료하세요.

2. 계정을 추가하려면 클릭하세요.

   대시보드를 열고 "계정 추가"를 클릭하세요. 팝업 창에서 "OAuth 인증"을 선택한 상태에서 "OAuth 인증 시작"을 클릭하세요.

3. 브라우저에서 올바른 계정을 선택하세요

   Google 로그인을 완료하고 인증 페이지를 확인하세요. 브라우저가 다른 계정을 사용하는 경우 먼저 이번에 추가할 계정으로 전환한 후 승인을 확인하고 콜백을 기다립니다.

4. 성공 메시지를 확인한 후 도구로 돌아갑니다.

   웹 페이지에 Authorization Successful가 나타난 후 Manager로 돌아가서 계정이 추가되었는지 확인하세요. 창이 자동으로 열리지 않으면 이번에 도구에서 생성된 인증 링크를 복사하여 자신의 브라우저에서 엽니다. 수동으로 다시 전화해야 하는 경우 현재 창의 프롬프트에 따라 붙여넣으세요.

계정이 로그인 가능하다고 해서 대상 모델이 반드시 사용 가능한 것은 아닙니다. 서비스를 계속 시작하기 전에 확인 또는 권한 예외를 처리하세요.

1. 계정 관리에 들어가서 새로 고침

   "계정 관리"를 열고 새로 추가된 계정의 할당량을 새로 고칩니다. 이메일 주소가 올바른지, 통화하려는 모델에 사용 가능한 할당량이 있는지 확인하세요.

2. 비정상적인 계정을 먼저 처리하세요

   403가 표시되거나, 계정을 확인해야 하거나, 계정이 비활성화되었거나, 할당량이 0인 경우 자세한 이유를 먼저 확인하세요. 비정상적인 계정을 사용 풀에 직접 추가하지 마십시오. 처리 방법은 마지막 단계를 참조하세요.

3. 일반 계정을 선택하고 활성화하십시오.

   원본 게시물에 따라 사용할 계정을 확인하고 "활성화"를 클릭하세요. 여러 계정을 사용하는 경우 상태를 하나씩 확인하세요. 귀하가 승인하고 사용할 수 있는 계정만 활성화하십시오.

4. 모델명 및 실제 가용성 확인

   인터페이스의 패키지 ID, 백분율 및 모델 목록은 현재 계정의 결과입니다. 스크린샷에 표시된 100%는 귀하의 계정이 동일하다는 의미도 아니며, 모든 모델을 호출할 수 있다는 의미도 아닙니다.

먼저 로컬 프록시 서비스를 시작한 다음 클라이언트에 대한 연결 정보를 입력합니다.

1. API 역생성 페이지로 들어가세요

   상단의 "API Reverse Generation"을 클릭하시면 서비스 구성 영역을 찾으실 수 있습니다. 처음 시작할 때 프로젝트 위험 설명이 있을 수 있습니다. 시작 여부를 결정하기 전에 꼭 읽어보시기 바랍니다. 확인창을 닫아도 서비스가 시작되지 않습니다.

2. 서비스를 활성화하거나 시작하려면 클릭하세요.

   버튼 이름은 버전에 따라 변경될 수 있습니다. 시작한 후에는 녹색 "서비스 실행 중"과 사용 가능한 계정 수가 표시됩니다. 사진에서는 이미 실행 중이므로 오른쪽 버튼에 "서비스 중지"가 표시됩니다.

3. 포트 및 액세스 범위 확인

   원본 게시물의 포트는 8045이며, 실제 포트는 사용자의 창을 기반으로 합니다. 동일한 컴퓨터를 사용하는 경우 로컬 접속만 유지하고 접속 인증을 활성화하세요. 튜토리얼을 따르기 위해 LAN이나 공용 네트워크를 열 필요는 없습니다. 포트를 수정한 후 프롬프트에 따라 서비스를 다시 시작하십시오.

4. 프로그램과 서비스를 계속 실행하세요.

   클라이언트 요청은 Manager를 통과합니다. 도구를 종료하거나 서비스를 중지한 후 로컬 주소는 모델 응답을 제공할 수 없습니다. 필요한 경우 사용자 정의 설정에 따라 애플리케이션으로 시작할 수 있습니다.

세 가지 정보는 모두 자체 Manager에서 얻습니다. 아래 주소와 모델은 원본 게시물의 예일 뿐입니다.

1. Base URL: OpenAI 프로토콜 카드 발견

   API 역생성 페이지에서 "Multi-Protocol Support"를 찾아 이 글에서 사용된 OpenAI 프로토콜 카드를 선택한 후 "Copy BASE"를 클릭하세요. 동일한 기계의 예는 http://127.0.0.1:8045/v1입니다. 포트를 수정한 경우에는 달라집니다.

2. API Key: 로컬 서비스의 키를 복사합니다.

   서비스 구성 영역에서 "API 키"를 찾아 오른쪽에 있는 복사 버튼을 클릭하세요. 여기에 입력해야 할 것은 Google의 비밀번호나 구매한 OpenAI API Key가 아닌 Manager의 게이트웨이 키입니다.

3. 모델 ID: 지원되는 모델 목록에서 가져옴

   "지원 모델 및 통합"에서 필요한 모델 ID를 복사합니다. 원본 게시물은 gemini-3.1-pro를 사용합니다. 귀하의 계정에서 현재 사용 가능하고 실제로 서버에 나열된 모델에 우선순위를 부여하십시오. 표시 이름과 모델 ID를 혼동하지 마십시오.

4. 클라이언트와 서비스가 동일한 컴퓨터에 있는지 확인

   127.0.0.1는 현재 클라이언트를 실행 중인 장치를 가리킵니다. 귀하의 휴대폰, 다른 컴퓨터, 원격 서버 또는 컨테이너는 귀하의 데스크톱 서비스에 자동으로 액세스하지 않습니다. 이 문서에서는 먼저 동일한 머신 연결을 완료한 다음 별도로 다른 배포를 계획합니다.

본 글에서는 OpenAI 호환 프로토콜을 사용하여 로컬 게이트웨이에 연결하며, 설정, 모델 서비스, 추가 순으로 동작한다.

1. 서비스 제공업체를 추가하려면 입구를 찾으세요.

   Cherry Studio를 열고 왼쪽 하단의 "설정", 왼쪽의 "모델 서비스", 서비스 공급자 목록 하단의 "추가"를 클릭합니다.

2. 호환되는 프로토콜 및 이름 선택

   공급자 이름은 "Anti-Gravity Anti-Generation"으로 쓸 수 있고 공급자 유형은 "OpenAI"로 선택한 다음 확인을 클릭할 수 있습니다. 여기에서 인터페이스 프로토콜이 선택되며 실제로 호출되는 모델은 다음 모델 ID에 의해 결정됩니다.

3. 자신의 키와 API 주소를 입력하세요.

   새로운 서비스 제공업체 세부정보를 입력하고 방금 복사한 API 키와 기본 URL을 입력하세요. 원래 게시물 예제는 http://127.0.0.1:8045/v1입니다. 아래 요청 미리보기를 참조하여 /v1이 한 번만 나타나고 /chat/completions로 끝나는지 확인하세요. 전체 요청 경로를 BASE로 입력하지 마세요.

4. 모델 추가 및 서비스 제공자 공개

   실제 지원되는 모델을 추가하려면 "모델 목록 가져오기"를 클릭하세요. 목록을 얻을 수 없는 경우 더하기 기호를 통해 서버에서 제공한 모델 ID를 수동으로 채울 수 있습니다. 원본 게시물은 gemini-3.1-pro입니다. 마지막으로 오른쪽 상단에 있는 스위치가 켜져 있는지 확인하세요.

연결이 성공했는지 확인하는 것뿐만 아니라 대화가 반환될 수 있는지 확인하고 Manager에서 해당 요청을 확인하는 것도 필요합니다.

1. API 키 오른쪽에 있는 감지를 클릭하세요.

   테스트가 끝날 때까지 기다리십시오. 성공하면 "연결 성공" 또는 체크 표시가 표시됩니다. 감지에 실패하면 먼저 Manager가 실행 중인지, 주소와 포트가 일치하는지, 키와 모델 ID가 올바른지 확인하세요.

2. 새 대화를 만들고 올바른 모델을 선택하세요.

   채팅 페이지로 돌아가서 새 대화를 만드세요. 다른 이전 서비스 제공업체를 계속 사용하지 않으려면 상위 모델 선택의 "반중력 역방향 생성"에서 대상 모델을 찾으세요.

3. 테스트할 작은 질문 게시

   예를 들어 "API가 무엇인지 한 문장으로 설명해주세요." 완전한 응답을 받은 후 후속 질문을 보냅니다. 모델의 자체 보고된 아이덴티티는 텍스트 콘텐츠로만 사용될 수 있으며 백그라운드에서 어떤 모델이 사용되는지 독립적으로 증명할 수 없습니다.

4. 이 요청을 확인하려면 Manager로 이동하세요.

   시간, 모델, 결과가 이 대화와 일치하는지 확인하려면 트래픽 로그를 확인하거나 모니터링을 요청하세요. 연결 감지, 실제 응답, 서버 요청 기록이 일치해야 연결 프로세스가 완료됩니다.

먼저 서비스가 시작되지 않았는지, 주소 또는 키가 일치하지 않는지, 계정 확인 및 업스트림 제한이 있는지 구별한 후 해당 조치를 취합니다.

1. 계정 추가에 실패했거나 시간이 초과되었습니다.

   fetch failed, 시간 초과 및 기타 프롬프트는 먼저 네트워크 연결, 소프트웨어 에이전트 및 브라우저 인증 콜백을 확인합니다. 필요한 경우 자체 TUN 설정을 시도하고 공식 로그인이 열릴 수 있는지 확인한 다음 인증을 다시 시작하십시오. 만료된 인증 코드를 계속해서 재사용하지 마십시오.

2. 403 및 계정을 확인해야 한다는 메시지가 명확하게 표시됩니다.

   Google 공식 로그인 페이지 또는 공식 앱에서 필요한 확인을 완료하세요. 원본 게시물은 휴대폰 Google App를 사용하여 해당 계정에 로그인한 후 프롬프트를 따릅니다. 구체적인 방법은 당시의 공식 요구 사항을 따릅니다. 완료 후 도구로 돌아가서 할당량을 다시 승인하거나 새로 고치세요.

3. 계정이 비활성화되었거나 제한되었습니다.

   수동 비활성화, 자격 증명 무효화 및 업스트림 제한을 구별하려면 먼저 "이유 보기"를 클릭하세요. 아직 정식 서비스를 이용할 수 없는 경우 복구 또는 이의제기 포털에 따라 처리됩니다. 원래 게시물에서는 기다리고 다시 시도하는 것은 개인적인 경험에 따른 것이라고 언급했습니다. 복구는 보장되지 않으며 고정된 솔루션이 아닙니다.

4. 연결이 거부됨, 401, 404 또는 모델을 사용할 수 없음

   연결이 거부되면 먼저 서비스가 실행 중인지, 포트를 확인하세요. 401, 게이트웨이 키와 액세스 권한을 확인하세요. 404, 경로가 반복되는지 확인하세요. /v1; 모델 오류의 경우 ID 모델과 실제 권한을 확인하세요. 429는 먼저 프롬프트에 따라 대기하고 동시성을 줄이고, 502는 서버 로그를 기반으로 업스트림과 네트워크를 확인합니다.