Get API

GET API · 개발자 연동

여러 모델에 OpenAI 호환 형식을 사용하세요.

Get API는 https://relay-api.getapi.pro/v1 을 base URL로 사용하고 Bearer API 키로 인증하며, `/chat/completions`에서 `model`과 `messages`를 포함한 JSON 본문을 받습니다. 호환성은 기본 마이그레이션 작업을 줄여 주지만 모든 공급자별 매개변수가 동일해지는 것은 아닙니다. 전체 매개변수, 스트리밍 동작, 오류 처리는 통합 가이드를 참조하세요.

최소 요청은 네 부분으로 구성됩니다.

기본 URL, API 키, 모델 식별자 및 메시지 배열이 최소 호출을 구성합니다. 먼저 일반 비스트리밍 텍스트 요청을 설정한 다음 스트리밍, 도구, 구조화된 출력 또는 미디어 입력을 한 번에 하나씩 추가하세요.

  • 기본 URL: https://relay-api.getapi.pro/v1
  • Authorization: Bearer 뒤에 API 키 지정
  • 현재 카탈로그에서 모델 선택

호환성이 모든 기능의 동일성을 뜻하지는 않습니다

공통 메시지 구조는 유지되더라도 역할, 샘플링 설정, 도구, 미디어 형식은 모델별로 다를 수 있습니다. 별도 알림 없이 처리되는 필드에 의존하지 말고, 핵심 기능 이외의 각 기능을 명시적으로 검증하세요.

  • 각 선택적 매개변수에 대한 테스트를 만드세요.
  • 실제 오류 응답을 보관하세요.
  • 다운스트림 응답 구조 검증

자격 증명과 프롬프트 로그 보호

API 키를 브라우저 소스, 공개 저장소, 사용자가 볼 수 있는 로그에 포함해서는 안 됩니다. 서버 측 애플리케이션은 운영에 필요한 요청·오류 정보만 보관하고, 민감한 프롬프트를 불필요하게 저장하지 않아야 합니다.

  • 서버 측 시크릿이나 시크릿 관리 도구를 사용하세요
  • 브라우저가 개발자가 운영하는 백엔드를 호출하도록 하세요
  • 인증 정보와 민감한 내용을 마스킹하세요

Python 요청 예제

openai 패키지를 설치한 후 로컬 터미널이나 서버에서 실행하세요. 본인의 키와 사용 가능한 모델을 사용하세요. 실제 요청에는 요금이 발생할 수 있습니다. 웹페이지에 키를 넣지 마세요. 이전 예제는 서버 환경 변수로 제공자를 선택하며 자동 재시도나 자동 전환을 수행하지 않습니다.

# python -m pip install openai
from getpass import getpass
from openai import OpenAI

model = input("Model identifier from the Get API catalog: ").strip()
with OpenAI(
    base_url="https://relay-api.getapi.pro/v1",
    api_key=getpass("Get API key: "),
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "Reply with a short greeting."}],
    )
    print(response.choices[0].message.content)

자주 묻는 질문

완전한 채팅 엔드포인트란 무엇입니까?

전체 엔드포인트는 https://relay-api.getapi.pro/v1/chat/completions 입니다.

브라우저에서 공개된 기본 URL을 직접 호출해도 되나요?

URL은 공개되지만 프로덕션 API 키는 브라우저 코드에 노출되어서는 안 됩니다. 자체 보안 백엔드를 사용하세요.

OpenAI 매개변수가 다른 모델에서 작동하지 않는 이유는 무엇입니까?

호환성은 일반적인 요청 형태를 다루는 반면, 모델별 기능은 실제 지원 및 문서화된 매핑에 따라 달라집니다.

비즈니스 문의: business@honeykid.cn