빠른 시작

아래 예제를 통해 iwinv AI API를 바로 시작해보세요.

1. SDK 설치

# Python
pip install openai

# Node.js
npm install openai

2. 클라이언트 초기화

Python

from openai import OpenAI
import os

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.IWINV_API_KEY,
  baseURL: "https://ai-api.iwinv.kr/v1",
});

3. 첫 번째 요청

Python

response = client.chat.completions.create(
    model="gemma4-26b",
    messages=[
        {"role": "user", "content": "안녕하세요!"}
    ]
)

print(response.choices[0].message.content)

Node.js

const response = await client.chat.completions.create({
  model: "gemma4-26b",
  messages: [{ role: "user", content: "안녕하세요!" }],
});

console.log(response.choices[0].message.content);

cURL

curl https://ai-api.iwinv.kr/v1/chat/completions \
  -H "Authorization: Bearer $IWINV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4-26b",
    "messages": [
      {"role": "user", "content": "안녕하세요!"}
    ]
  }'

4. 기존 OpenAI 코드 마이그레이션

기존에 OpenAI를 사용하던 코드라면 두 줄만 변경하면 됩니다.

# 기존 OpenAI 코드
client = OpenAI(
    api_key="sk-...",          # 변경 전
    # base_url 없음            # 변경 전
)

# iwinv로 전환
client = OpenAI(
    api_key="iwinv-...",                        # ← API Key 변경
    base_url="https://ai-api.iwinv.kr/v1"       # ← base_url 추가
)

팁

model 파라미터도 iwinv 모델 ID로 변경해야 합니다.
전체 모델 목록은 모델 지정 페이지를 참고하세요.