문서

API 문서

Base URL과 API 키만 바꾸면 OpenAI·Anthropic·Gemini 형식의 기존 코드와 대부분의 AI 클라이언트에서 바로 사용할 수 있습니다.

시작하기

회원가입 후 콘솔의 토큰 메뉴에서 API 키를 만듭니다. ② 아래 Base URL을 클라이언트의 주소로 설정합니다. ③ 요청 헤더에 키를 넣어 호출합니다.

Base URL
https://api.ferouter.ai
OpenAI 호환 주소
https://api.ferouter.ai/v1
인증 헤더
Authorization: Bearer sk-xxxxxxxx
키 형식
sk- 로 시작하는 48자

일부 클라이언트는 Base URL 끝에 /v1을 자동으로 붙입니다. 그럴 때는 https://api.ferouter.ai까지만 입력하세요.

엔드포인트

OpenAI 형식을 기본으로 지원하고, Anthropic·Gemini 네이티브 형식도 같은 키로 호출할 수 있습니다.

채팅
POST /v1/chat/completions
텍스트 완성
POST /v1/completions
임베딩
POST /v1/embeddings
이미지 생성
POST /v1/images/generations
음성 합성
POST /v1/audio/speech
음성 인식
POST /v1/audio/transcriptions
모델 목록
GET /v1/models
Anthropic 형식
POST /v1/messages
Gemini 형식
POST /v1beta/models/{model}:generateContent
영상 생성(비동기)
POST /v1/video/generations → GET /v1/video/tasks/{id}

코드 예제

modelauto를 넣으면 FE Router가 최적 모델을 고르고, 모델 ID를 넣으면 해당 모델을 고정합니다. stream: true로 SSE 스트리밍을 받을 수 있습니다.

curl https://api.ferouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $FE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"안녕하세요"}],"stream":true}'
from openai import OpenAI
client = OpenAI(base_url="https://api.ferouter.ai/v1", api_key="FE_API_KEY")
stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "안녕하세요"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ferouter.ai/v1", apiKey: process.env.FE_API_KEY });
const res = await client.chat.completions.create({
  model: "claude-3-7-sonnet",
  messages: [{ role: "user", content: "안녕하세요" }],
});
console.log(res.choices[0].message.content);
curl https://api.ferouter.ai/v1/messages \
  -H "x-api-key: $FE_API_KEY" -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-3-7-sonnet","max_tokens":1024,"messages":[{"role":"user","content":"안녕하세요"}]}'

클라이언트 설정

아래 프로그램에서는 설정 화면에 Base URL과 API 키만 입력하면 됩니다.

Cherry Studio
위치
설정 → 모델 제공자 → OpenAI 호환 추가
Base URL
https://api.ferouter.ai
API Key
sk-…
ChatBox
위치
설정 → 모델 제공자 → Custom Provider
Base URL
https://api.ferouter.ai
API Key
sk-…
NextChat
위치
설정 → 커스텀 엔드포인트 켜기
Base URL
https://api.ferouter.ai
API Key
sk-…
LobeChat
위치
설정 → 언어 모델 → OpenAI
Base URL
https://api.ferouter.ai
API Key
sk-…
Cursor
위치
Settings → Models → OpenAI API Key → Override Base URL
Base URL
https://api.ferouter.ai
API Key
sk-…
Continue (VS Code)
위치
config.json → provider: openai
Base URL
https://api.ferouter.ai
API Key
sk-…
Open WebUI
위치
관리자 → 연결 → OpenAI API
Base URL
https://api.ferouter.ai
API Key
sk-…
Immersive Translate
위치
번역 서비스 → OpenAI → 커스텀 API 주소
Base URL
https://api.ferouter.ai
API Key
sk-…

모델명과 auto 라우팅

  • auto — 요청의 목적·길이·언어와 모델별 품질·속도·비용을 평가해 최적 모델로 보냅니다. 응답의 model 필드에 실제 사용된 모델이 담깁니다.
  • auto:fast — 속도 우선, auto:quality — 품질 우선, auto:cheap — 비용 우선.
  • 모델 ID를 직접 지정하면 라우팅 없이 해당 모델로 고정됩니다. 사용 가능한 ID는 모델 가격 또는 GET /v1/models에서 확인합니다.

요금 계산

비용 = (입력 토큰 × 입력 단가 + 출력 토큰 × 출력 단가) ÷ 1,000,000 × 그룹 배율

예) gpt-4o로 입력 1,200 토큰·출력 800 토큰을 처리하면 (1,200 × $2.50 + 800 × $10.00) ÷ 1,000,000 = $0.011. 이미지·영상·음성은 장·초·분 단위 단가로 계산되며, 잔액에서 즉시 차감됩니다.

오류 코드

401
키가 없거나 잘못됨 · 키가 만료됨
403
키의 한도 소진 · 허용되지 않은 모델 · 허용되지 않은 IP
404
존재하지 않는 모델 ID
429
요청 빈도 초과 — 잠시 후 재시도(지수 백오프 권장)
500 / 502
상류 모델 오류 — 자동 전환 실패 시 반환
503
해당 모델 일시 이용 불가

한도와 정책

  • 기본 그룹 분당 요청 600회·분당 토큰 2M. 더 필요하면 프로 그룹 또는 기업 문의.
  • 키마다 사용 한도·만료일·허용 모델·IP 화이트리스트를 설정할 수 있습니다.
  • 요청·응답 본문은 모델 학습에 사용되지 않으며, 로그에는 모델명·토큰 수·지연·비용 등 사용량 메타데이터만 기록됩니다.
  • 오류(4xx·5xx) 응답은 과금되지 않습니다.