4-4 AI 빠른 시작: 5분 만에 통합 AI API 연결
이 튜토리얼은 4-4 AI 연결을 처음부터 끝까지 안내합니다: 키 발급 → Base URL 설정 → 첫 스트리밍 출력 실행까지. 전 과정에서 OpenAI 호환 인터페이스를 사용합니다——커스텀 Base URL을 지원하는 기존 코드·프레임워크·도구(openai SDK, LangChain, Cursor 등)는 코드 로직을 바꿀 필요 없이 설정만 바꾸면 됩니다.
사전 준비
- www.4-4.vip에 접속해 계정을 등록하고 콘솔에 로그인합니다.
- 콘솔에서 충전하거나 카드 코드로 크레딧을 교환합니다.
- 「토큰」 페이지에서 새 API 키(
sk-...형식)를 생성하고 안전하게 보관하세요——생성 시 한 번만 완전하게 표시됩니다.
핵심 개념: Base URL과 키
4-4 AI는 OpenAI와 완전히 호환되는 인터페이스 프로토콜을 제공합니다. 기억할 설정은 두 가지뿐입니다:
| 설정 항목 | 값 |
|---|---|
| Base URL | https://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);
주요 프레임워크·도구 연결
- LangChain / LlamaIndex: OpenAI 호환 컴포넌트를 사용해
base_url/openai_api_base를 위 주소로 설정하면 됩니다. - Cursor / Claude Code / Cherry Studio 등 AI 도구: 「커스텀 API / OpenAI 호환」 설정에 Base URL과 키를 입력합니다.
- 자체 개발 프로그램: OpenAI 프로토콜을 지원하는 어떤 HTTP 클라이언트로도 직접 호출할 수 있으며 추가 SDK가 필요 없습니다.
자주 묻는 질문(FAQ)
401 Invalid API Key 오류가 나올 때는?
순서대로 확인하세요: ① 키 복사 시 공백이나 줄바꿈이 섞였는지; ② 콘솔 토큰 목록에서 해당 키가 비활성화/삭제되지 않았는지; ③ 계정 크레딧이 소진되지 않았는지; ④ Authorization 헤더 형식이 Bearer sk-...인지(Bearer 뒤에 공백이 있어야 합니다).
429 요청이 너무 많을 때는?
게이트웨이는 토큰별로 속도 제한을 두고 있습니다. 동시 요청을 줄이고 재시도 백오프를 늘리고(지수 백오프 + 지터 권장) 콘솔에서 토큰의 속도 상한을 올리세요.
스트리밍 출력이 중간에 끊길 때는?
긴 응답에는 SDK의 타임아웃 재시도를 켜는 것을 권장합니다. 회사 프록시를 거친다면 프록시가 SSE 스트림(text/event-stream)을 버퍼링하지 않는지 확인하세요.
어떤 모델을 지원하나요?
콘솔 「모델」 페이지의 실시간 목록이 기준입니다. 4-4 AI는 GLM, DeepSeek, Qwen 등 주요 모델을 통합하며 같은 키·같은 인터페이스로 전환할 수 있습니다.
관련 글
하나의 키로 GLM, DeepSeek, Qwen 등 주요 모델에 통합 연결. 통합 과금과 사용량 시각화를 지원합니다.
모델 및 요금 보기 가입하고 사용하기