BizRouter 비즈라우터

프로바이더별 파라미터

GPT-5/GPT-6, Gemini, Perplexity 모델에만 있는 확장 파라미터와 프로바이더별 지원 범위입니다. 아래 예시와 파라미터는 Chat Completions API 기준이며, Responses API와 Messages API에서의 차이는 각 API 문서에 있습니다.

GPT-5/GPT-6 파라미터

OpenAI 추론 모델에서 지원하는 특수 파라미터 verbosity string 모델별 상이 응답의 상세 정도를 제어 허용 값: low, medium, high reasoning_effort string 모델별 상이 추론 작업에 대한 계산 노력을 제어 허용 값: none, minimal, low, medium, high, xhigh, max GPT-5/GPT-6 파라미터 참고사항 GPT-5 패밀리와 GPT-6 Astra에서 작동합니다 선택적 파라미터이며, 제공하지 않으면 기본값이 사용됩니다 허용 값은 모델마다 다릅니다. GPT-5.6 Sol, Terra, Luna는 none, low, medium, high, xhigh, max 를 지원합니다 GPT-6 Astra는 low, medium, high, xhigh, max 만 지원하며 none 과 minimal 은 지원하지 않습니다 GPT-6 Astra에서는 temperature , top_p , logprobs , top_logprobs 를 보내지 마십시오. BizRouter는 모델 테스트 요청에서 이 값을 자동으로 제외합니다 GPT-5.4 이상 계열은 OpenAI의 chat/completions에서 함수 도구(tools)와 추론을 함께 쓸 수 없습니다 (OpenAI 제약). BizRouter는 이런 요청을 Responses API로 변환해 보내므로 추론과 도구 호출이 함께 동작하고, reasoning_effort 에 none 외 값을 명시해도 그대로 적용됩니다. 응답 모양은 chat/completions와 같습니다. 단, Responses API에 대응하는 값이 없는 파라미터( logprobs , n , seed , stop , frequency_penalty 등)가 있으면 변환하지 않고 예전처럼 "none" 으로 도구만 호출합니다 OpenAI의 GPT-6 함수 도구는 Responses API에서만 지원됩니다. BizRouter는 이 모델의 Chat Completions 요청을 Responses 형식으로 자동 변환하므로 기존 Chat 클라이언트에서도 함수 도구를 사용할 수 있습니다

Gemini Thinking 파라미터

Gemini 2.5 / 3.0 시리즈 모델의 추론(Thinking) 기능 제어 thinking_budget integer 추론에 사용할 토큰 수를 직접 지정 허용 값: -1 또는 0 ~ 8192 지원 모델: Gemini 2.5 시리즈 thinking_level string 추론 수준을 지정 허용 값: low, high 지원 모델: Gemini 3.x 시리즈 include_thoughts boolean 추론 과정 요약을 응답에 포함 허용 값: true, false 지원 모델: Gemini 2.5 / 3.x Gemini Thinking 파라미터 참고사항 thinking_budget : Gemini 2.5 시리즈 전용. 최대 8192 토큰까지 지정 (0으로 비활성화) thinking_level : Gemini 3.x 시리즈 권장. "high"가 기본값 thinking_budget 과 thinking_level 을 동시에 사용하면 오류 발생 특수값: -1은 동적 thinking (요청 복잡도에 따라 자동 조절)

Gemini Google 검색 그라운딩

Gemini 모델이 답하기 전에 Google 검색을 실행하고, 답변에 출처를 붙입니다 OpenAI 표준 파라미터 web_search_options 를 보내면 Gemini의 google_search 도구로 바꿔 전달합니다. 값은 빈 객체면 충분하고, 함수 도구( tools )와 함께 써도 됩니다. 검색이 실제로 실행된 응답에는 아래 세 가지가 함께 옵니다. message.annotations[] OpenAI 형식의 url_citation (url·title·start_index·end_index). 문장 단위로 어떤 출처가 근거인지 알려줘요. start_index·end_index는 답변 텍스트 기준 문자 위치입니다. message.grounding_metadata Gemini가 돌려준 groundingMetadata 원본(webSearchQueries·groundingChunks·groundingSupports·searchEntryPoint) usage.web_search_calls 요금이 매겨진 검색 횟수. Gemini 3.x는 실행된 검색 질의 수, Gemini 2.x는 그라운딩된 요청 1건 기준입니다.

Gemini Google 검색 그라운딩 · 응답 예시 (일부)

알아 두십시오 스트리밍에서는 마지막 텍스트 청크 직전에 delta.annotations · delta.grounding_metadata 가 한 청크로 오고, usage 청크에 web_search_calls 가 담깁니다. 모델이 검색이 필요 없다고 판단하면 검색이 실행되지 않고 위 필드도 오지 않습니다. 검색 요금도 없습니다. 검색 요금은 토큰 요금과 별도로 붙습니다(Gemini 3.x 검색 1회 $0.014, Gemini 2.x 그라운딩 요청 1건 $0.035). 실제 적용 금액은 응답 usage.cost 와 사용량 화면에서 확인할 수 있습니다. Gemini 외 모델에 web_search_options 를 보내면 조용히 무시하지 않고 adapter_mapping_unavailable (400)로 알립니다. Responses API에서는 tools: [ { "type": "web_search" } ] 가 같은 기능입니다. 자세한 내용은 Responses 문서 에 있습니다.

Gemini 영상 입력

영상을 분석하도록 보내는 방법과 Gemini 영상 파라미터 지원 범위 영상은 video_url 콘텐츠로 보냅니다. 모델 목록( GET /v1/models )에서 input_modalities 에 video 가 있는 모델만 영상을 받습니다. 영상 토큰 요금은 Gemini가 보고한 토큰 수 기준이며, 응답 usage.cost 에서 확인할 수 있습니다. video_url.url string 필수 data:video/mp4;base64,… 형식의 데이터 URI(디코딩 기준 20MB 이하) 또는 공개 YouTube 주소( https://www.youtube.com/watch?v=… , https://youtu.be/… , shorts·live 주소)입니다. YouTube 주소는 BizRouter가 내려받지 않고 Gemini에 그대로 전달하여 Google이 직접 영상을 읽습니다. 비공개·일부공개 영상은 읽을 수 없습니다. 그 밖의 외부 주소는 받지 않으며 400으로 안내합니다. video_url.fps number 초당 분석 프레임 수입니다. 0 초과 24 이하이며 생략하면 Gemini 기본값(1)입니다. video_url.start_offset / end_offset number | string 분석할 구간입니다. 초 단위 숫자( 40 , 1.5 ) 또는 "40s" 형식 문자열을 받습니다. 시작이 끝보다 늦으면 400입니다. video_url 안에 직접 쓰거나 video_url.video_metadata 객체 안에 같은 이름으로 쓸 수 있습니다. media_resolution string 요청 본문 최상위에 두며, 이미지·영상 프레임 하나에 배정할 토큰 상한을 정합니다. low · medium · high 또는 Gemini 표기 MEDIA_RESOLUTION_LOW · MEDIA_RESOLUTION_MEDIUM · MEDIA_RESOLUTION_HIGH 를 받습니다. 낮게 정하면 입력 토큰이 줄어 요금이 낮아집니다. Gemini 모델에서만 적용되며, Claude 모델처럼 이 값을 변환할 수 없는 모델에 보내면 adapter_mapping_unavailable (400)입니다.

Gemini 영상 입력 · 파일 영상(base64)

알아 두십시오 OpenAI의 { "type": "file", "file": { "file_data": "data:video/mp4;base64,…" } } 형식도 받으며, 데이터 URI의 미디어 형식(video·audio·image)에 따라 위 콘텐츠와 같게 처리합니다. PDF 등 그 밖의 파일 형식과 file_id 는 지원하지 않습니다. fps 를 높이거나 구간을 길게 잡을수록 입력 토큰이 늘어납니다. 긴 YouTube 영상은 구간을 지정하고 media_resolution 을 낮추는 편이 좋습니다. 크레딧 예약은 링크 영상 하나당 최대 12만 토큰 기준으로 잡고, 실제 청구는 Gemini가 보고한 토큰 수로 정산합니다. 프레임 단위로 해상도를 따로 정하는 설정과 Google Files API 업로드 주소는 아직 지원하지 않습니다.

Perplexity 검색 파라미터

Perplexity 모델의 실시간 웹 검색 기능 제어 search_domain_filter string[] 검색 결과를 특정 도메인으로 제한 search_recency_filter string 검색 결과의 최신성 필터 (day, week, month, year) return_images boolean 검색 결과에 이미지 포함 return_related_questions boolean 관련 질문 포함 search_mode string 검색 모드 설정

Perplexity 검색 파라미터 · Perplexity 검색 예시

응답 메타데이터 Perplexity 응답에는 search_results , related_questions , cost 등의 메타데이터가 포함됩니다.

프로바이더별 파라미터 지원

각 프로바이더가 지원하는 주요 파라미터 파라미터 OpenAI Anthropic Google xAI Perplexity temperature ✅ ✅ ✅ ✅ ✅ top_p ✅ ✅ ✅ ✅ ✅ top_k ❌ ✅ ✅ ❌ ❌ tools ✅ ✅ ✅ ✅ ❌ response_format ✅ json_schema ✅ ✅ ❌ 이미지 입력 ✅ ✅ ✅ ✅ ❌ 호환성 참고 parameter 지원 범위와 validation은 Provider 및 모델에 따라 다릅니다. GET /v1/models 의 supported_parameters 와 response_format_modes , provider_response_format_modes 로 확인할 수 있습니다.

주식회사 AI3 | 서울 강남구 영동대로85길 34 | support@bizrouter.ai