본문으로 건너뛰기

OpenAI 호환

OpenAI 코드는 그대로, 기본 URL만 바꾸세요

SpicyAPI는 OpenAI chat completions 형식을 지원합니다. 호환되는 SDK, 프레임워크, 채팅 앱의 연결 대상을 저희 기본 URL로 바꾸고 카탈로그의 모델 ID를 지정하면, 평소처럼 스트리밍으로 응답을 받을 수 있습니다.

OpenAI 호환 API란?

OpenAI 채팅 API와 같은 형식의 요청을 받는다는 뜻입니다. OpenAI용으로 만든 도구라면 설정 세 가지만 바꾸면 SpicyAPI와 연결됩니다.

  1. 내 앱 또는 채팅 클라이언트OpenAI SDK, LangChain, SillyTavern…
  2. SpicyAPIapi.spicyapi.ai/v1
  3. 채팅 모델키 하나로 26개 모델
코드는 계속 OpenAI 형식으로 요청을 보냅니다. 주소, 키, 모델 이름만 바뀝니다.

이런 용도에 적합합니다

  • OpenAI SDK를 쓰는 앱주소와 키만 바꾸세요. 나머지 코드는 그대로입니다.
  • 롤플레이·채팅 앱SillyTavern, RisuAI, Agnai는 커스텀 OpenAI 엔드포인트로 연결됩니다.
  • 에이전트 프레임워크LangChain, Vercel AI SDK, Aider는 각 도구의 OpenAI 어댑터를 통해 사용할 수 있습니다.

3단계로 연결하기

  1. 1단계

    API 키 만들기

    로그인한 뒤 콘솔에서 키를 만드세요. 키는 sk-spicy-로 시작합니다.

    header
    Authorization: Bearer sk-spicy-…
  2. 2단계

    기본 URL 바꾸기

    OpenAI 주소를 https://api.spicyapi.ai/v1로 바꾸세요.

    base URL
    https://api.spicyapi.ai/v1
  3. 3단계

    모델 ID 고르기

    아래 목록에서 채팅 모델 ID를 복사해 첫 메시지를 보내 보세요.

    model
    xai/grok-4.7/chat

바꿀 값은 세 가지

대부분의 클라이언트가 /chat/completions를 알아서 붙이므로 기본 URL은 /v1까지만 입력하세요. 전체 엔드포인트를 요구하는 앱에는 https://api.spicyapi.ai/v1/chat/completions를 입력합니다.

  • 기본 URLhttps://api.openai.com/v1https://api.spicyapi.ai/v1
  • API 키sk-proj-…sk-spicy-…
  • 모델gpt-4o채팅 모델 ID 선택

클라이언트별 설정

이미 쓰고 있는 SDK, 프레임워크, 앱의 스니펫을 복사하세요. 사용하는 도구를 클릭하면 해당 스니펫으로 이동합니다.

curl https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CATALOG",
    "messages": [{ "role": "user", "content": "Write a two-line opening scene." }],
    "stream": true
  }'

서드파티 클라이언트는 버전에 따라 설정 형식이 바뀌기도 합니다. 여기 있는 스니펫이 맞지 않으면 해당 클라이언트의 공식 문서를 따라 주세요.

사용할 수 있는 채팅 모델

ID는 표시된 그대로 복사하세요. 가격과 컨텍스트 한도는 각 모델 페이지에서 확인할 수 있습니다.

모든 채팅 모델 (26)

자주 만나는 오류 해결

처음 사용할 때 겪는 문제는 대부분 이 세 가지 중 하나입니다. 각 카드에서 증상과 바꿔야 할 항목을 확인하세요.

  • 401

    인증 실패

    키가 없거나 OpenAI 키를 보냈습니다. SpicyAPI 키를 보내세요: Authorization: Bearer sk-spicy-…

  • 404

    찾을 수 없음

    기본 URL 경로가 한 단계 어긋났습니다. 도메인만 쓰거나 /chat/completions를 두 번 붙이지 말고 https://api.spicyapi.ai/v1을 사용하세요.

  • 모델

    모델을 찾을 수 없음

    gpt-4o 같은 OpenAI 모델 이름은 여기서 별칭으로 쓸 수 없습니다. maker/model/chat 형식의 전체 ID를 사용하세요.

자주 묻는 질문