GetAPI.ONE API 요청 보내기

사전 조건 및 범위

• GETAPI_ONE_API_KEY에 저장된 범위를 제한한 GetAPI.ONE 키.
• 호출할 엔드포인트 유형을 명시적으로 나열하는 현재 카탈로그 모델.
• curl이 설치되어 있고 www.getapi.one으로 나가는 HTTPS가 허용된 명령줄.
• 실제 요청에 사용 요금이 발생할 수 있음을 수락해야 합니다. 예제는 모델 요청을 보내지 않고 검토했습니다.

• 키 생성 및 로드
• 엔드포인트 호환 모델 선택

1. 명시된 엔드포인트 선택

다른 프로토콜 계열은 경로와 요청 본문이 다릅니다. 선택한 모델 페이지의 엔드포인트를 따르며 Anthropic, Gemini, 이미지, 비디오 호출을 위 두 예제로 통일하지 마세요.

2. Responses API 예제

Responses 엔드포인트를 나열하는 카탈로그 모델을 선택한 후에만 사용하세요. 실행 전에 YOUR_RESPONSES_MODEL을 교체하세요.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Chat Completions 예제

선택한 카탈로그 모델에 OpenAI Chat 엔드포인트가 나열된 경우에만 사용하세요. 실행 전에 YOUR_CHAT_MODEL을 바꾸세요.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. 결과 확인

1. 먼저 HTTP 상태를 읽으세요. 2xx는 게이트웨이가 HTTP 요청을 수락하고 완료했다는 뜻이지만 클라이언트는 응답 객체에 기대한 출력이 있는지도 확인해야 합니다.
2. Responses는 반환된 status/output 구조를, Chat Completions는 choices 구조를 확인하세요. 서로 다른 프로토콜에 같은 응답 형태를 가정하지 마세요.
3. GetAPI.ONE 요청 또는 사용 로그에서 시간, 엔드포인트, 모델, 제공되는 경우 요청 식별자를 대조하세요.

스트리밍과 재시도

스트리밍은 응답 전달과 이벤트 처리를 바꾸며 지원 여부는 선택한 엔드포인트와 모델에 따라 다릅니다. 비스트리밍 요청으로 시작하고 stream 매개변수를 추가하기 전에 프로토콜 참조와 모델 페이지를 확인하세요.

• 인증, 한도, 권한, 모델 선택 오류를 자동 재시도하지 마세요.
• 시간 초과나 업스트림 실패를 재시도하기 전에 원래 요청이 처리되었을 가능성과 반복 실행이 안전한지 확인하세요.
• 애플리케이션에서 재시도 횟수를 제한하고 대기 시간을 늘리며, 진단을 위해 요청 식별자와 타임스탬프를 보존하세요.

오류별 처리

• 문제 해결 확인 목록
• 지원 보고 준비