개요

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

지금 부를 수 있는 것#

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

주소#

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

엔드포인트#

왜 여기서 사나요#

• 원화로 결제해요. 해외 결제 카드가 없어도 돼요.
• 세금계산서를 발행해요. 경비 처리가 되는 경로예요.
• 학교장터(S2B)로도 살 수 있어요.
• 한 경로가 막히면 자동으로 다른 경로로 재시도해요.
• 글·그림·음성은 프롬프트와 응답 본문을 저장하지 않아요. 사용량만 기록해요. 영상만 결과를 받으실 수 있게 요청 문장과 영상 파일을 7일 보관하고 지워요.

60초 만에 첫 호출#

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

한도 — 분당 몇 건까지 되나요#

「분당 몇 건」 제한을 두지 않아요. 수업 중에 서른 명이 한꺼번에 눌러도 저희 쪽에서 막지 않습니다. 대신 돈으로 막아요 — 키마다 이번 달 한도를 걸어두시면 그 키만 멈추고 나머지 분들은 그대로 쓰십니다.

• 402 — 계정 잔액이 모자랍니다. 부르기 전에 미리 나오니 요금이 붙지 않아요.
• 429 — 그 키의 이번 달 한도에 닿았어요. 대시보드에서 올리시면 바로 풀립니다.
• 429 (벤더가 낸 것) — 벤더가 잠시 조인 경우예요. 저희가 같은 모델의 다른 경로로 다시 걸어보고, 몇 번째에 됐는지 x-gateway-fallback-depth 헤더에 담아 드려요.

이 문서를 AI 에게 넘기시려면 마크다운 원문을 쓰세요 — 주소 끝에 .md 를 붙이면 나와요.