본문으로 건너뛰기

API 가이드

AI API를 단계별로 연동하는 가이드. API 키 발급과 관리, 인증 방식, 엔드포인트와 SDK, OpenAI 호환 설정, 운영 환경에서의 호출 패턴을 설명합니다.
  • 글 70개
  • 최근 업데이트 2026년 10월 10일
API 프로젝트의 권한과 결제를 확인하고 Astra에 요청해 첫 응답을 받는 흐름과 별도로 확인해야 하는 ChatGPT 구독

GPT-6 Astra API 사용 방법: 프로젝트 권한 확인부터 첫 응답까지

GPT-6 Astra는 API에서 제공 중입니다. 실제 호출 가능 여부는 사용하는 API 조직·프로젝트와 결제 상태에 따라 달라집니다. Python 예제로 첫 요청을 보내고, 정상 응답·출력 중단·인증 및 한도 오류를 구분하는 방법을 안내합니다.

6 분
Grok Voice Agent API의 접속 주소, 인증과 음성 서비스 선택을 보여 주는 안내 그림

Grok Voice Agent API 가이드: 웹소켓 접속부터 음성 입출력까지

Grok Voice Agent API는 wss://api.x.ai/v1/realtime에서 양방향 음성 대화를 제공합니다. 서버에서는 API 키, 브라우저에서는 단기 토큰으로 인증합니다. WAV 파일을 전송하고 응답을 재생 가능한 파일로 저장하는 예제로 시작한 뒤 자동 발화 감지와 중단 처리를 연결할 수 있습니다.

11 분
Gemini 3 Pro Image의 일반 요청과 비동기 Batch 이미지 생성을 비교한 개념도

Gemini 3 Pro Image Batch API: 반값 요금과 이미지 회수까지

Gemini 3 Pro Image의 Batch 요금은 같은 작업의 Standard 요금 대비 50%입니다. 다만 이미지 출력 단가가 최종 비용 전부는 아닙니다. 총비용 계산부터 JSONL 요청 작성, 이미지 저장, 실패 요청만 다시 처리하는 흐름까지 연결합니다.

7 분
같은 서버 프로세스에서 DNS·TLS·프록시와 HTTP 응답을 나누어 연결 오류를 확인하는 안내

OpenAI API 연결 오류: APIConnectionError는 경로부터 확인하세요

APIConnectionError가 발생하면 키를 바꾸기 전에 같은 서버 프로세스의 연결 경로와 원래 예외를 확인하세요. DNS·인증서·프록시·엔드포인트에 맞는 수정과 Python·Node의 진단 설정, 같은 요청으로 복구를 확인하는 절차를 설명합니다.

10 분
OpenAI API quota 오류를 잔액, 강제 지출 상한과 승인 사용 한도로 나누어 복구하는 안내

OpenAI API quota exceeded 오류: 잔액·지출 한도 확인과 복구

OpenAI API에서 quota exceeded가 나오면 error.code부터 확인하세요. 크레딧 소진은 잔액을 추가하고, 강제 지출 상한은 권한 있는 담당자가 조정하며, 승인된 사용 한도는 증액 절차로 해결해야 합니다. 충전 후에도 같은 조직·프로젝트·모델의 요청이 성공해야 복구를 확인할 수 있습니다.

7 분
Assistant 설정과 Thread 대화, Run 실행을 Responses의 설정·상태·도구 처리로 옮기는 흐름

OpenAI Assistants API를 Responses API로 마이그레이션하는 방법

Assistants API는 이미 종료됐습니다. 앱에 남아 있는 설정과 대화 기록을 기준으로 Responses 요청을 구성하고, 도구 결과와 검색 근거를 확인한 뒤 트래픽을 전환해야 합니다. 장애 시 돌아갈 대상도 동작하는 Responses 버전으로 준비합니다.

10 분