한 줄 정의

OpenAI-compatible는 기존 OpenAI 코드를 적은 수정으로 옮기게 해 주는 호환 인터페이스 개념이야. openai compatible라고 띄어 쓰기도 하고, 핵심은 다른 AI 서비스가 OpenAI API의 SDK와 요청 모양을 거의 그대로 받아 준다는 데 있어.

이 말은 제품 이름도 아니고 모델 이름도 아니야. 보통 API key, base URL, model name 정도만 바꿔서 연동하거나 호출 경로를 바꿔 적용한다는 뜻으로 쓰이고, 그 서비스가 OpenAI와 완전히 같은 가격표나 기능표를 가진다는 뜻은 아니야.

어떻게 작동하나

실무에서 이 표현이 붙는 곳은 대개 API 호출 모양이 비슷하다는 뜻이야. 예를 들어 Model Studio 문서는 호환 모드 경로를 따로 두고 POST .../compatible-mode/v1/chat/completions로 요청을 보내게 해. 본문도 chat 응답 경로처럼 messages 배열 중심으로 받는 예시를 보여 줘서, 이미 OpenAI SDK나 그 형식을 전제로 짜 둔 내부 코드와 통합을 크게 뜯지 않고 새 벤더로 연동 경로를 바꿔 적용할 수 있게 해 줘.

여기서 OpenAI API와의 차이도 같이 봐야 해. OpenAI API는 OpenAI가 직접 운영하는 실제 서비스 경로고, 이 표현은 다른 서비스가 그 형식을 흉내 내거나 맞춰 둔 호환층이라는 점이 다르다. 또 chat completions 경로는 그 호환층 안에서 자주 보이는 구체 엔드포인트 이름이고, Responses API는 또 다른 응답 형식 계열이야. 즉 이 페이지의 용어는 특정 엔드포인트 하나보다 한 단계 위에 있는 개념이야.

이 개념이 Alibaba 쪽 문구에만 갇힌 것도 아니야. LM Studio 문서도 OpenAI 호환 endpoint를 따로 열고 base URL만 바꿔 기존 OpenAI client를 재사용하는 흐름을 안내해. 그래서 이 표현은 한 벤더의 마케팅 문구라기보다, 여러 서비스가 기존 OpenAI 호출 방식을 받아들이는 패턴에 더 가까워.

Qwen API reference가 인터페이스를 3가지, 즉 chat completions 계열, Responses 계열, DashScope 네이티브 인터페이스로 나눠 소개하는 것도 같은 맥락이야. 호환 모드는 기존 OpenAI 앱과 도구를 빨리 옮기기 좋은 길에 가깝고, 벤더 고유 기능까지 가장 넓게 여는 통로는 네이티브 인터페이스일 수 있어.

왜 중요한가

이 말이 중요한 이유는 마이그레이션 비용을 빨리 가르게 해 주기 때문이야. 문서에 이 표현이 보이면 적어도 SDK, 요청 본문, 엔드포인트 구조는 익숙한 쪽일 가능성이 크다. 특히 OpenAI SDK를 전제로 짜 둔 내부 코드나, 기존 OpenAI client 재사용을 노리는 agent 통합이 있으면 새 모델을 도입할 때도 완전히 새 API를 배우는 문제보다 호출 경로와 설정을 조정하는 문제로 줄어드는 경우가 많아.

기사나 제품 소개를 읽을 때도 쓸모가 커. 어떤 서비스가 이 말을 적어 놓았다고 해서 그 서비스의 가격표, 지역 정책, 인증 체계, 지원 기능 전체가 OpenAI와 같다는 뜻은 아니야. 그래서 이 표현을 보면 먼저 호환되는 게 요청 형식인지, 도구 생태계인지, 기능 범위까지 거의 같은지를 분리해서 봐야 판단이 빨라진다.

문서를 실제로 검토할 때는 세 가지만 먼저 보면 돼.

  • base URL이 어디로 바뀌는지 봐.
  • 인증 방식이 정말 같은지 확인해.
  • 네이티브 API를 따로 보라고 적혀 있는지 체크해.

실제로 도입 전에 SDK 연동 포인트, base URL 설정, 인증 설정, 네이티브 API 추가 적용 여부를 같이 확인하면 판단이 훨씬 빨라져.

주의해서 볼 것

첫째, 호환과 동일을 섞으면 안 돼. Alibaba Cloud quick start만 봐도 Singapore, US (Virginia), China (Beijing)처럼 지역마다 base URL이 다르고, API key도 지역 간에 서로 바꿔 쓰지 못한다고 적혀 있다. 즉 이 말은 대개 호출 모양 호환이지, 운영 조건까지 완전 복제라는 뜻은 아니야.

둘째, 네이티브 인터페이스가 더 많은 기능을 줄 수 있어. Qwen API reference는 DashScope를 OpenAI 계열 경로와 따로 분리한 네이티브 인터페이스로 설명해. 이런 문서 구조 자체가 벤더 전용 파라미터나 추가 기능이 별도 경로에 있을 수 있다는 신호야. 그래서 호환 모드가 붙어 있어도 최신 기능, 벤더 전용 파라미터, 내장 도구 호출 같은 건 네이티브 API 쪽 문서를 따로 봐야 할 수 있어.

셋째, 이 말은 특정 벤더 전용 용어가 아니야. Model Studio처럼 한 서비스의 사례로 자주 보이지만, 뜻 자체는 다른 서비스가 OpenAI 형식을 받아 주는 호환층이라는 일반 개념에 더 가까워. 문서를 읽을 때는 먼저 이게 개념 설명인지, 특정 제품 문서인지부터 가르는 게 덜 헷갈려.