본문으로 건너뛰기

인증

모든 API 요청은 HTTP 헤더에 Authorization: Bearer {API_KEY} 형식으로 인증 정보를 포함해야 합니다.
API Key는 iwinv 콘솔에서 발급받을 수 있습니다.

경고

API Key는 외부에 노출되지 않도록 주의하세요.
Key 유출로 인한 무단 사용 요금은 환불되지 않습니다.

요청 헤더

Authorization: Bearer iwinv-xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

환경변수로 관리 (권장)

API Key를 코드에 직접 작성하지 말고 환경변수로 관리하세요.

# Linux / macOS
export IWINV_API_KEY=iwinv-xxxxxxxxxxxxxxxxxxxx

# Windows (PowerShell)
$env:IWINV_API_KEY="iwinv-xxxxxxxxxxxxxxxxxxxx"
import os
from openai import OpenAI

client = OpenAI(
api_key=os.environ["IWINV_API_KEY"],
base_url="https://ai-api.iwinv.kr/v1"
)

Key 관리 주의사항

  • 사용하지 않는 API Key는 즉시 삭제하세요.
  • 예산을 설정하여 예상치 못한 과금을 방지하세요.
  • Key는 iwinv 클라우드 내부 서버에서만 작동합니다.
  • Key가 정상 작동하지 않으면 온라인 기술지원을 신청하세요.