문서
Unify API는 OpenAI API와 호환됩니다. 코드에서 이미 OpenAI를 호출하고 있다면 기본 URL과 키만 변경하십시오. 나머지는 그대로입니다.
빠른 시작
계정을 만들어 키를 받은 후, 클라이언트가 https://api.unifyapi.ai/v1을(를) 가리키도록 설정하십시오.
curl https://api.unifyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $UNIFYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5",
"messages": [{"role": "user", "content": "Hello"}]
}'기존 SDK 사용하기
OpenAI 호환 클라이언트라면 모두 작동합니다. 기본 URL과 Unify API 키를 설정하십시오.
from openai import OpenAI
client = OpenAI(
api_key=os.environ["UNIFYAPI_KEY"],
base_url="https://api.unifyapi.ai/v1",
)
response = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Hello"}],
)Anthropic 방식의 클라이언트는 같은 키로 /v1/messages을(를) 대신 사용할 수 있습니다.
인증
모든 요청에 키를 Bearer 토큰으로 전달하십시오. 키는 콘솔에서 생성하고 취소하며, 키마다 특정 모델로 범위를 제한하고 별도의 지출 한도를 설정할 수 있습니다.
Authorization: Bearer sk-...엔드포인트
| POST /v1/chat/completions | OpenAI 호환 채팅 |
| POST /v1/messages | Anthropic 호환 메시지 |
| POST /v1/responses | OpenAI Responses API |
| POST /v1/embeddings | 텍스트 임베딩 |
| POST /v1/images/generations | 이미지 생성 |
| GET /v1/models | 키로 사용 가능한 모델 목록 조회 |
GET /v1/models을(를) 호출하면 키로 접근할 수 있는 모델을 정확히 확인할 수 있습니다. 이 목록이 고객님 계정의 공식 기준입니다.
모델 선택
키로 접근할 수 있는 모델을 model 필드에 지정하십시오. Unify API는 해당 모델을 제공하는 제공업체로 요청을 라우팅하고, 그 제공업체의 성능이 저하되면 자동으로 장애 조치하므로, 업스트림 장애 중에도 하나의 모델 이름으로 계속 작동합니다.
오류
오류는 OpenAI 오류 형식을 따르므로 기존 오류 처리 로직이 그대로 작동합니다. 401은(는) 키가 없거나 취소되었음을 의미하고, 429은(는) 요청 한도 또는 지출 한도에 도달했음을 의미합니다. 두 경우 모두 콘솔에서 확인할 수 있습니다.