공지: 클링 Kling 4.0 출시, 텍스트→비디오 및 이미지→비디오 20% 할인 한정 진행, 지금 체험하기
HiAPI
튜토리얼

MCP 원클릭

HiAPI Remote MCP를 사용하면 Claude, ChatGPT, Codex 등 AI 클라이언트에서 HiAPI로 이미지, 영상, 오디오를 생성할 수 있습니다.

AI 도구 선택

이 프롬프트를 Codex에 보내세요

이 클라이언트의 채팅에 붙여 넣으면 연결 설정과 인증 시작을 대신 처리합니다.

  1. 1 「프롬프트 복사」 클릭
  2. 2 Codex 대화창에 붙여 넣고 전송
  3. 3 브라우저에 HiAPI 승인 페이지가 열리면 로그인하고 할당량을 선택한 뒤 승인
제가 실제로 사용하는 환경에서 HiAPI MCP를 연결해 주세요. 제가 직접 해야 하는 단계(클라이언트에서 버튼 클릭, 브라우저에서 승인)는 모두 알려 주세요. 제가 할 일은 그것뿐이니 명령어나 코드, 콜백 URL을 붙여 넣으라고 요청하지 마세요.

대상 클라이언트: Codex
서버 이름: hiapi
MCP URL: https://mcp.hiapi.ai/mcp (Streamable HTTP + OAuth)

다음 순서대로 진행하세요:
1. 자신이 Codex인지 확인하고, 그 판단에 근거한 환경 증거(플랫폼, 그리고 자신의 설정 또는 플러그인 디렉터리가 있는지)를 밝히세요. 자기 선언만으로는 충분하지 않습니다. 아래 설정은 모두 실제로 실행 중인 환경(macOS / Linux / Windows / WSL, 로컬 또는 원격 서버)에서 진행하세요.
2. 먼저 `codex mcp get hiapi`를 실행하세요. 존재하지 않는 경우에만 `codex mcp add hiapi --url https://mcp.hiapi.ai/mcp --oauth-client-id hiapi-codex`를 실행하세요. 같은 URL로 이미 존재한다면 그대로 두세요.
3. Codex는 추가 직후 브라우저를 열어 승인을 요청합니다. 제가 마칠 때까지 기다리세요. 그렇지 않거나 `codex mcp list`에 hiapi가 여전히 로그인되지 않은 것으로 표시되면 `codex mcp login hiapi`를 실행하고 제가 브라우저에서 승인할 때까지 기다리세요. 이어서 HiAPI 승인 페이지가 열리고, 거기서 제가 로그인하고 승인한 뒤 할당량을 설정합니다. 브라우저가 열리지 않으면 위에 설명한 대로 링크를 주세요. 로그인은 최대 한 번만 시작하세요.
4. 승인 후 hiapi의 get_balance를 호출해 정상 동작하는지 확인하세요. 호출이 실패하면 한 번 재시도할 수 있고, 다시 실패하면 중단하고 정확한 오류를 보여 주세요. 비용이 발생하는 도구(이미지, 동영상, 오디오, 텍스트 생성)는 호출하지 마세요. 이 세션에서 아직 hiapi 도구가 보이지 않는다면 다시 로그인하지 말고 세션을 재시작해 달라고 요청하세요.
5. 설정 파일을 편집할 때 다른 항목은 유지하고, 액세스 토큰, 인증 코드, code_verifier 또는 기타 자격 증명을 채팅, 로그, 명령어 출력에 절대 노출하지 마세요.
6. 완료하면 두 부분으로 간단히 보고하세요. 직접 확인한 것: 어떤 설정을 변경했는지(파일 또는 앱 내 설정. 이미 있었고 그대로 두었다면 그렇게 밝히세요), 그리고 잔액 확인 결과와 잔액. 제가 확인해야 할 것: 제가 브라우저에서 승인했는지, 클라이언트를 재시작해야 하는지.

발견한 내용이 이 단계들과 조금만 다르다면(예: 설정 파일이 아직 없거나, 기존 항목의 형식이 조금 다른 경우) 실제로 있는 상태를 기준으로 진행하고, 편차를 보고서에 하나씩 짚어 주세요. 화면이나 설정이 없거나, 명령어가 존재하지 않거나, 위에 적힌 클라이언트가 아니거나, 이 단계를 벗어난 변경이 필요하다면 다른 방법을 추측하지 말고 중단한 뒤 보이는 그대로 알려 주세요.
실제로 수행하고 확인한 것만 보고하세요. 제 쪽 일(예: 브라우저에서 승인했는지)을 볼 수 없다면 완료라고 하지 말고 "확인 대기 중"이라고 적으세요.

수동 설정

직접 설정을 편집하려면 아래 명령이나 파일 내용을 복사하세요.

서버 주소
https://mcp.hiapi.ai/mcp
추가
codex mcp add hiapi --url https://mcp.hiapi.ai/mcp --oauth-client-id hiapi-codex
로그인
codex mcp login hiapi

자주 묻는 문제

클라이언트가 연결되지 않음
URL이 https://mcp.hiapi.ai/mcp이고 전송 방식이 HTTP(Streamable)인지 확인하세요.
잔액 또는 할당량 부족 오류
콘솔에서 충전한 뒤 다시 시도 ↗
생성 결과가 아직 나오지 않음
작업이 아직 실행 중입니다. 다시 제출하지 말고 같은 task_id로 AI가 계속 조회하게 하세요.

연결된 앱 관리