4-4 AI 빠른 시작: 5분 만에 통합 AI API 연결

튜토리얼 · 2026-11-20 · 약 8분 읽기

이 튜토리얼은 4-4 AI 연결을 처음부터 끝까지 안내합니다: 키 발급 → Base URL 설정 → 첫 스트리밍 출력 실행까지. 전 과정에서 OpenAI 호환 인터페이스를 사용합니다——커스텀 Base URL을 지원하는 기존 코드·프레임워크·도구(openai SDK, LangChain, Cursor 등)는 코드 로직을 바꿀 필요 없이 설정만 바꾸면 됩니다.

사전 준비

  1. www.4-4.vip에 접속해 계정을 등록하고 콘솔에 로그인합니다.
  2. 콘솔에서 충전하거나 카드 코드로 크레딧을 교환합니다.
  3. 「토큰」 페이지에서 새 API 키(sk-... 형식)를 생성하고 안전하게 보관하세요——생성 시 한 번만 완전하게 표시됩니다.
보안 참고: API 키는 계정 크레딧과 같습니다. Git 저장소나 프런트엔드 코드에 커밋하지 마세요. 환경 변수로 관리하는 것을 권장합니다.

핵심 개념: Base URL과 키

4-4 AI는 OpenAI와 완전히 호환되는 인터페이스 프로토콜을 제공합니다. 기억할 설정은 두 가지뿐입니다:

설정 항목값
Base URLhttps://www.4-4.vip/v1
API Key콘솔 토큰 페이지에서 생성한 sk-... 키
model 파라미터필요에 따라 모델명을 입력합니다. 예: deepseek-chat, glm-4 등(콘솔 모델 목록 기준)

모델 전환 = model 파라미터만 변경. 공급자 전환 = Base URL만 변경. 이것이 통합 게이트웨이의 핵심 가치입니다: 비즈니스 코드와 모델 공급자의 분리.

방법 1: cURL(연결 확인이 가장 빠름)

curl https://www.4-4.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $44AI_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

반환된 JSON에 choices[0].message.content가 포함되어 있으면 전체 링크가 정상 연결된 것입니다.

방법 2: Python(openai 공식 SDK)

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["44AI_API_KEY"],          # your 4-4 AI key
    base_url="https://www.4-4.vip/v1"            # key: point to the 4-4 AI gateway
)

# regular call
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)

# streaming output
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if delta and delta.content:
        print(delta.content, end="", flush=True)

방법 3: Node.js

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.N44_API_KEY,
  baseURL: "https://www.4-4.vip/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);

주요 프레임워크·도구 연결

자주 묻는 질문(FAQ)

401 Invalid API Key 오류가 나올 때는?

순서대로 확인하세요: ① 키 복사 시 공백이나 줄바꿈이 섞였는지; ② 콘솔 토큰 목록에서 해당 키가 비활성화/삭제되지 않았는지; ③ 계정 크레딧이 소진되지 않았는지; ④ Authorization 헤더 형식이 Bearer sk-...인지(Bearer 뒤에 공백이 있어야 합니다).

429 요청이 너무 많을 때는?

게이트웨이는 토큰별로 속도 제한을 두고 있습니다. 동시 요청을 줄이고 재시도 백오프를 늘리고(지수 백오프 + 지터 권장) 콘솔에서 토큰의 속도 상한을 올리세요.

스트리밍 출력이 중간에 끊길 때는?

긴 응답에는 SDK의 타임아웃 재시도를 켜는 것을 권장합니다. 회사 프록시를 거친다면 프록시가 SSE 스트림(text/event-stream)을 버퍼링하지 않는지 확인하세요.

어떤 모델을 지원하나요?

콘솔 「모델」 페이지의 실시간 목록이 기준입니다. 4-4 AI는 GLM, DeepSeek, Qwen 등 주요 모델을 통합하며 같은 키·같은 인터페이스로 전환할 수 있습니다.

관련 글

셀프호스트 one-api / new-api vs 관리형 AI 게이트웨이: 비용·운영·보안 비교 게이트웨이를 직접 구축할지 고민하는 팀을 위한 솔직한 의사결정 프레임워크: 숨은 운영 비용, 장애 시나리오 비교, 어떤 단계에서 어떤 선택이 맞는지. Cursor / Claude Code / Cherry Studio를 커스텀 AI 게이트웨이에 연결하는 가이드 주요 AI 코딩·채팅 도구의 커스텀 Base URL 설정 방법, 401/404/모델 사용 불가 빠른 문제 해결 매뉴얼 포함.
연결할 준비가 되셨나요?

하나의 키로 GLM, DeepSeek, Qwen 등 주요 모델에 통합 연결. 통합 과금과 사용량 시각화를 지원합니다.

모델 및 요금 보기 가입하고 사용하기