Skip to content

Claude OpenAI 호환 형식 ​

Fast-Token은 OpenAI API 프로토콜로 Anthropic Claude 시리즈 모델을 호출할 수 있습니다. OpenAI SDK 또는 /v1/chat/completions 기반 앱이 있다면 보통 base_url과 model만 변경하면 Claude에 연결할 수 있으며, Anthropic Messages 네이티브 API로 다시 작성할 필요가 없습니다.

이 페이지는 사용 안내가 중심입니다. 각 인터페이스의 요청 본문, 응답 필드, 온라인 디버깅은 ChatGPT 문서 및 아래 기능 대조표 링크를 참고하세요.

두 가지 연동 방식 ​

비교 항목OpenAI 호환 형식(본 페이지)Claude 네이티브 API(동일 디렉터리 기타 문서)
일반적인 경로POST /v1/chat/completionsPOST /v1/messages
요청 본문messages, model, stream 등 OpenAI 필드messages, system, thinking 등 Anthropic 필드
적합한 경우기존 OpenAI 클라이언트, 다중 모델 통합 게이트웨이, 빠른 이전Claude 전용 기능(확장 사고 예산, Tool Use, PDF, 웹 검색 등)
문서 위치본 페이지 + 채팅 그룹본 폴더 「채팅」 그룹의 API 페이지

두 방식은 동일한 API Key와 게이트웨이 주소를 공유합니다. 요금은 모델 광장의 해당 모델을 기준으로 합니다.

연동 설정 ​

게이트웨이 및 인증 ​

  • Base URL: https://fast-token.com/v1 (빠른 시작과 동일)
  • 인증: 요청 헤더 Authorization: Bearer <Fast-Token_API_KEY>
  • 모델 이름: 모델 광장에서 claude가 포함된 모델 ID를 복사해 model 필드에 입력

OpenAI SDK 사용(권장) ​

공식 SDK의 base_url을 Fast-Token으로 지정하면 나머지는 OpenAI와 동일합니다:

python
from openai import OpenAI

client = OpenAI(
    base_url="https://fast-token.com/v1",
    api_key="<Fast-Token_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-sonnet-4-20250514",  # 모델 광장 기준
    messages=[
        {"role": "user", "content": "用一句话介绍你自己"},
    ],
)
print(completion.choices[0].message.content)
javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://fast-token.com/v1",
  apiKey: "<Fast-Token_API_KEY>",
});

const completion = await client.chat.completions.create({
  model: "claude-sonnet-4-20250514",
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(completion.choices[0].message.content);

스트리밍 대화는 stream: true로 설정하세요. 채팅 완료 생성(스트리밍) 참고.

chat 호환 형식 기능 개요 ​

아래 기능은 모두 OpenAI 호환 경로로 접근합니다. 콘솔 또는 Apifox에서는 「chat 호환 형식」으로 분류되는 경우가 많습니다. 구현상 대부분 동일한 POST /v1/chat/completions이며 모델, 스트리밍, 메시지 구조로 시나리오를 구분합니다.

기능설명참고 문서
사고 채팅 생성모델 「사고」 과정이 포함된 대화스트리밍 (extra_body.enable_thinking)
채팅 완료 생성(스트리밍)표준 다중 턴 텍스트 대화, SSE 스트리밍채팅 완료 생성(스트리밍)
채팅 완료 생성(비스트리밍)표준 다중 턴 텍스트 대화, 일괄 응답채팅 완료 생성(비스트리밍)
채팅 이미지 인식(스트리밍)이미지 업로드로 이해·설명·질의채팅 이미지 인식 생성(스트리밍)
채팅 이미지 인식(비스트리밍)이미지 인식, 비스트리밍 전체 응답채팅 이미지 인식 생성(비스트리밍)

모델 선택

각 시나리오의 모델 ID는 모델 광장을 기준으로 하세요. 이름에 claude가 있고 해당 대화·이미지 인식·사고를 지원한다고 표시된 모델을 시도하세요. 「모델 없음」 또는 미지원이면 동일 시나리오의 다른 Claude 항목으로 바꾸세요.

시나리오별 사용 요점 ​

표준 채팅(스트리밍 / 비스트리밍) ​

  • 엔드포인트: POST /v1/chat/completions
  • messages 배열로 다중 턴 대화 유지; role은 system / user / assistant(OpenAI와 동일)
  • 비스트리밍: stream: false 또는 stream 생략 → 채팅 완료 생성(비스트리밍)
  • 스트리밍: stream: true → 채팅 완료 생성(스트리밍)
  • 공통 매개변수(temperature, max_tokens, top_p 등)는 OpenAI 문서와 동일

system 역할

OpenAI 형식에서는 messages의 role: "system"에 시스템 프롬프트를 작성합니다. 네이티브 Claude API는 상위 system 필드를 자주 사용합니다. → 채팅 완료 생성(스트리밍)

사고 모드(사고 채팅 생성) ​

일부 Claude 사고 모델은 스트리밍 요청에서 확장 필드로 사고 출력을 켤 수 있습니다:

json
{
  "model": "claude-sonnet-4-20250514",
  "messages": [{ "role": "user", "content": "逐步推导:为什么天空是蓝色的?" }],
  "stream": true,
  "extra_body": {
    "enable_thinking": true
  }
}
  • 호환 형식에서 사고 표시 방식은 게이트웨이와 모델에 따라 다릅니다. 모델 광장에서 「사고」를 지원하는 Claude 모델을 선택하세요
  • 사고 토큰 예산(thinking.budget_tokens)을 정밀 제어하고 사고 블록과 본문 블록을 구분하려면 네이티브 확장 사고 채팅 생성(POST /v1/messages)을 사용하세요

이미지 인식(비전) ​

user 메시지 content에 멀티모달 배열: text + image_url(URL 또는 Base64)을 사용합니다.

json
{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "描述这张图片中的主要内容" },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/photo.jpg" }
        }
      ]
    }
  ],
  "stream": true
}

OpenAI 호환 vs 네이티브 Claude API 선택 ​

요구 사항권장
빠른 연동, OpenAI SDK / 기존 코드 재사용OpenAI 호환 형식(본 페이지)
확장 사고, budget_tokens, 사고 블록 SSE 구조네이티브 API — 확장 사고 채팅 생성
Tool Use / 함수 호출네이티브 API — 함수 호출 생성(스트리밍)
구조화 출력(JSON Schema)네이티브 API — 구조화된 출력 생성
PDF, 웹 검색네이티브 API — PDF 지원, 웹 검색
OpenAI 클라이언트로 「채팅 + 이미지 인식 + 사고」만 필요OpenAI 호환 형식으로 주 경로 커버

자주 묻는 질문 ​

Q: OpenAI 공식 문서와 완전히 같지 않은 이유는?
A: 호환 계층이 요청/응답을 OpenAI에 맞추고 실제는 Claude가 동작합니다. OpenAI 전용 매개변수 일부는 무시될 수 있으며, 실제 모델 지원을 기준으로 하세요.

Q: model에는 무엇을 넣나요?
A: 모델 광장의 전체 모델 ID(보통 claude 포함)를 사용하세요. 약칭이나 만료된 이름은 쓰지 마세요.

Q: Anthropic 공식 Python SDK를 쓸 수 있나요?
A: 기본 대상은 POST /v1/messages입니다. SDK를 유지하려면 본 폴더 네이티브 API 문서를 따르고, OpenAI SDK는 본 페이지 호환 형식용입니다.

Q: 스트리밍 응답 형식은?
A: SSE, data: {...} 행과 종료 data: [DONE], OpenAI 스트리밍 Chat Completions와 동일. → 채팅 완료 청크 객체

Q: 전체 응답 JSON 구조는?
A: → 채팅 완료 객체. 네이티브 Messages API: → 채팅 완료 객체(Anthropic 형식)

더 읽기 ​