Documentation

연동 문서

666 AI는 주요 프로토콜 세 가지를 지원합니다. 지금 쓰시는 도구는 대부분 그대로 연동됩니다. 주소 한 곳을 바꾸고 API Key 하나를 넣으면 되고, 나머지는 손대지 않으셔도 됩니다.

아래 예제의 YOUR-ENDPOINT를 본인의 접속 주소로 바꿔 주세요. 콘솔 첫 화면에서 확인할 수 있으며, 시작 가이드가 설정을 자동으로 만들어 주기도 합니다.

세 단계로 연동

가입부터 첫 요청이 성공하기까지 보통 3분이 걸리지 않습니다.

1. API Key 받기

콘솔의 「API Key」 페이지에서 새로 만드세요. 프로젝트마다 하나씩 만들고 사용 한도를 정해 두시길 권합니다.

2. 주소 입력하기

BASE URL
https://YOUR-ENDPOINT/v1

3. 확인하기

curl
curl https://YOUR-ENDPOINT/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"hi"}]}'

# A JSON response means it works

지원 프로토콜

API Key 하나, 잔액 하나로 세 가지 프로토콜을 자유롭게 쓰실 수 있습니다. 도구마다 다른 키를 준비하실 필요가 없습니다.

사용 가능
OpenAI
가장 널리 쓰이는 형식입니다. 대부분의 도구와 SDK가 기본으로 지원합니다.
/v1/chat/completions
사용 가능
Anthropic
Claude Code와 Cline의 기본 형식으로, 별도의 변환 계층이 필요 없습니다.
/v1/messages
준비 중
Gemini
Google의 기본 형식으로, 이미 Gemini용으로 작성된 프로젝트에 적합합니다.
/v1beta/models
고르기 어려우시면 OpenAI 형식을 쓰세요. 호환성이 가장 좋고, 모델을 바꿔도 코드를 고칠 필요가 없습니다.

OpenAI 형식

공식 openai 라이브러리를 그대로 쓰실 수 있습니다. 바꾸는 것은 base_url 하나뿐입니다.

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_KEY",
    base_url="https://YOUR-ENDPOINT/v1"
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_KEY",
  baseURL: "https://YOUR-ENDPOINT/v1"
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);

Anthropic 형식

Claude Code나 Anthropic 공식 SDK를 쓰신다면 이 형식을 고르세요. 변환 계층이 필요 없습니다. 이 주소에는 /v1이 붙지 않는 점에 유의해 주세요.

Claude Code
# Add to ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://YOUR-ENDPOINT"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"

# Reopen the terminal, then just run
claude
Python SDK
from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_KEY",
    base_url="https://YOUR-ENDPOINT"
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(msg.content[0].text)

Gemini 형식

준비 중입니다. 그때까지도 Gemini 계열 모델은 위의 OpenAI 형식으로 호출하실 수 있으며 기능은 동일합니다.

curl
# Call Gemini like this
curl https://YOUR-ENDPOINT/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"hi"}]}'

에디터와 에이전트

Cursor

  1. Settings → Models → OpenAI API Key
  2. Override Base URL 켜기
  3. 주소와 API Key를 넣고 Verify 클릭

Claude Code

  1. ANTHROPIC_BASE_URL 설정
  2. ANTHROPIC_AUTH_TOKEN 설정
  3. 터미널을 다시 열고 claude 실행

Cline / Roo Code

  1. Provider에서 OpenAI Compatible 선택
  2. Base URL과 API Key 입력
  3. Model ID에 카탈로그의 ID 입력

Continue

  1. config.json 편집
  2. provider에 openai 지정
  3. apiBase 항목 추가

앱과 확장 프로그램

ChatBox / NextChat

  1. 모델 서비스에서 OpenAI 선택
  2. API 도메인에 게이트웨이 주소 입력
  3. 모델 이름은 직접 입력

Immersive Translate

  1. 사용자 지정 AI 인터페이스 추가
  2. 주소는 /v1/chat/completions
  3. 빠르고 저렴한 모델을 권합니다

Open WebUI

  1. 설정 → 외부 연결
  2. OpenAI API 연결 추가
  3. 주소와 API Key를 넣고 저장

개발 프레임워크

Dify

  1. 모델 공급자에서 OpenAI-API-compatible 선택
  2. API endpoint와 API Key 입력
  3. 나머지 노드 설정은 그대로

n8n

  1. OpenAI 자격 증명 새로 만들기
  2. Base URL에 게이트웨이 주소 입력
  3. 노드에서 그 자격 증명 선택

LangChain

  1. ChatOpenAI 사용
  2. base_url 전달
  3. 나머지 체인은 그대로

스트리밍 / 도구 호출 / 비전

이 세 가지는 공식 인터페이스와 사용법이 완전히 같아서 파라미터를 바꾸실 필요가 없습니다. 지원 여부는 모델마다 다르며 모델 카탈로그에 표시해 두었습니다.

스트리밍 출력
stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role":"user","content":"写一首诗"}],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

프롬프트 캐시

매 요청이 같은 긴 앞부분(시스템 프롬프트, 프로젝트 코드, 문서)을 담고 있다면, 캐시에 맞은 부분은 큰 폭으로 할인되어 청구됩니다. 코딩과 에이전트 작업에서 효과가 가장 큽니다.

바뀌지 않는 내용을 앞에, 바뀌는 내용을 뒤에 두세요. 적중률을 좌우하는 것은 순서입니다.

오류 코드

코드의미조치 방법
401API Key가 유효하지 않거나 중지되었습니다API Key가 끝까지 복사되었는지, 삭제되지 않았는지 확인해 주세요
402잔액이 부족합니다콘솔에서 충전해 주세요
404모델을 찾을 수 없습니다모델 카탈로그와 대조해 ID 철자를 확인해 주세요
429요청이 너무 잦습니다동시 요청 수를 줄이거나 잠시 후 다시 시도해 주세요
500상위 서비스 오류입니다게이트웨이가 예비 경로로 자동 재시도합니다. 계속된다면 문의해 주세요

한도와 제한

API Key마다 사용 한도와 쓸 수 있는 모델 범위를 따로 정할 수 있습니다. 프로젝트마다 하나씩 만들어 두시면, 하나가 유출되어도 손실이 한도까지로 막히고 지운 뒤 다시 만들면 됩니다.

실패한 요청은 청구되지 않습니다. 시간 초과나 상위 서비스 오류는 청구서에 들어가지 않습니다.
←