개요

키 하나와 base_url 하나로 글·그림·음성·임베딩까지 다섯 벤더를 씁니다.

스쿨오더 AI API 는 여러 벤더의 모델을 하나의 키와 하나의 주소로 묶어주는 게이트웨이예요. 쓰던 OpenAI SDK 나 Anthropic SDK 에서 base_url 만 바꾸면 그대로 돌아가요.

지금 부를 수 있는 것

글만 있는 게 아니에요. 그림·읽어주기·받아쓰기·임베딩·검열까지 같은 키로 부르실 수 있어요. 종류마다 부르는 주소가 다르고, 아래 표의 주소를 그대로 쓰시면 돼요.

종류	모델	부르는 주소
글	52개	POST /v1/chat/completions
그림	7개	POST /v1/images/generations
임베딩	5개	POST /v1/embeddings
검열	2개	POST /v1/moderations
읽어주기	2개	POST /v1/audio/speech
받아쓰기	3개	POST /v1/audio/transcriptions
깊은 추론	6개	POST /v1/responses

모두 합쳐 77개 · 벤더 5곳(anthropic · deepinfra · google · openai · xai). 키가 없는 벤더는 아예 목록에 넣지 않아요 — 목록에 있는데 부르면 안 되는 게 제일 나쁘거든요.

주소

형식	base_url
OpenAI 호환 (Chat Completions)	https://schoolorder.kr/v1
Anthropic 네이티브 (Messages)	https://schoolorder.kr

OpenAI 형식으로 Claude 모델을 불러도 돼요. 게이트웨이가 요청과 응답을 번역해요 — 스트리밍도 포함이에요.

엔드포인트

메서드	경로	설명
POST	/v1/chat/completions	OpenAI 호환 채팅
POST	/v1/messages	Anthropic 네이티브 Messages
POST	/v1/responses	OpenAI Responses — pro 등급은 이 문으로만 불려요
POST	/v1/images/generations	그림 만들기
POST	/v1/images/edits	있는 그림 고치기
POST	/v1/audio/speech	글을 소리로 (읽어주기)
POST	/v1/audio/transcriptions	소리를 글로 (받아쓰기)
POST	/v1/embeddings	검색·추천용 벡터
POST	/v1/moderations	부적절한 입력 걸러내기 (무료)
GET	/v1/models	쓸 수 있는 모델과 단가
GET	/v1/credits	남은 크레딧

왜 여기서 사나요

원화로 결제해요. 해외 결제 카드가 없어도 돼요.
세금계산서를 발행해요. 경비 처리가 되는 경로예요.
학교장터(S2B)로도 살 수 있어요.
한 경로가 막히면 자동으로 다른 경로로 재시도해요.
프롬프트와 응답 본문을 저장하지 않아요. 사용량만 기록해요.

60초 만에 첫 호출

bash

curl https://schoolorder.kr/v1/chat/completions \
  -H "Authorization: Bearer $SCHOOLORDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'