제1장 / 총 21장약 1분

YiTuoToken 개발자 연동 가이드

약 1분 읽기OpenAI 호환 프로토콜

🌐 언어 / Language:한국어 · English · 简体中文

개발자용 API 연동 핸드북 · OpenAI 호환 게이트웨이 서비스 도메인(자리표시자): http://183.240.79.21:52099 API 베이스 URL: http://183.240.79.21:52099/v1

YiTuoToken은 OpenAI 호환 대규모 모델 API 중계 게이트웨이입니다. 요청의 baseURL을 YiTuoToken 주소로 바꾸고 키를 YiTuoToken이 발급한 API 키로 교체하기만 하면, 하나의 OpenAI 스타일 호출 방식으로 GPT, Claude, Gemini, DeepSeek 등 주요 모델과 이미지, 오디오, 비디오, Midjourney 이미지 생성, 리랭크 등 멀티모달 기능에 접근할 수 있습니다.



1. 빠른 시작#

세 단계로 연동이 완료됩니다.

단계 1 · API 키 생성#

YiTuoToken 콘솔에 로그인하고 API 키 페이지로 이동해 sk-로 시작하는 키를 생성합니다. 평문은 생성 시 한 번만 표시됩니다. 즉시 복사해 보관하세요(자세한 내용은 2절 참고).

단계 2 · baseURL과 키 설정#

  • 베이스 URL: http://183.240.79.21:52099/v1
  • API 키: 본인의 sk-... 키

대부분의 기존 OpenAI 통합은 아래 두 곳만 교체하면 됩니다:

Diff
- baseURL: https://api.openai.com/v1
+ baseURL: http://183.240.79.21:52099/v1

- apiKey:  sk-你的原始Key
+ apiKey:  sk-你的YiTuoToken-Key

단계 3 · 첫 요청 보내기#

cURL
curl http://183.240.79.21:52099/v1/chat/completions \
  -H "Authorization: Bearer sk-你的YiTuoToken-Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "你好,请用一句话介绍你自己" }
    ]
  }'

chat.completion 구조가 반환되면 연동 성공입니다.

로컬 개발 참고: 로컬 Docker 모드에서 게이트웨이는 http://183.240.79.21:52099에 노출되며, 베이스 URL은 http://183.240.79.21:52099/v1입니다. 요청 경로는 단일 /v1입니다(예: /v1/chat/completions). /v1/v1/...로 쓰면 404가 반환됩니다.