잘못된 base_url을 사용하여
표준 OpenAI 기본 URL을 사용하면 요청이 실패하거나 완전히 다른 모델로 라우팅됩니다. 당사 API에서는 다음을 변경해야 합니다. base_url 수신하여 https://api.whatisopenrouterai.com/v1. 이 단일 구성 줄은 SDK가 전역 OpenAI 인프라 대신 당사 서버에 연결되도록 보장합니다.
많은 개발자는 이 변수를 업데이트하지 않고 기존 코드를 복사하여 붙여넣습니다. 기본 URL을 그대로 두면 404 오류가 발생하거나 Uncensored가 아닌 모델에 도달할 수 있습니다. 연결을 확인하여 항상 검증하십시오. /v1/models 엔드포인트입니다. 해당 페이지에 고유한 모델 ID가 나열되어 있어야 합니다. 이는 첫 번째 completion 요청을 보내기 전에 라우팅이 올바르게 설정되었음을 확인합니다.
모델 ID를 설정하지 않는 것을 잊지 마세요
올바른 베이스 URL을 사용하더라도 모델 ID를 생략하면 기본값은 일반 모델이나 이전 모델로 설정됩니다. 명시적으로 설정해야 합니다. model 파라미터를 "uncensored" 모든 요청에서. 이는 제한 없는 콘텐츠에 맞게 조정된 특정 오픈 웨이트 모델을 제공하도록 라우팅 레이어에 알립니다.
이 명시적인 지시사항이 없으면, 다른 정렬 규칙을 가진 다른 모델을 받을 수 있습니다. 일부 모델은 기본적으로 합법적인 성인 주제를 거부합니다. 강제함으로써 uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
토큰 제한 및 오류 무시
100,000 토큰 컨텍스트 윈도우 또는 16,000 토큰 출력 제한을 초과하면 요청이 즉시 실패합니다. 당사 API는 요청당 최대 출력 16,000 토큰을 강제합니다. 설정하지 않으면 max_tokens, 기본값은 2,048 토큰입니다. 이는 복잡한 추론 작업에는 종종 너무 짧습니다.
오류 및 거절은 선불 크레딧을 소모하지 않습니다. 그러나 속도 제한에 도달하거나 본문 크기(8 MB)를 초과하는 잘못된 요청은 할당량에 포함됩니다. 토큰 사용량을 확인하려면 응답 헤드를 모니터링하십시오. 컨텍스트 윈도우에 맞게 프롬프트 엔지니어링을 조정하십시오. 이는 비용이 많이 드는 재시도를 방지하고 원활한 데이터 흐름을 보장합니다.
사전 결제 청구 오해
계정 잔액은 월 구독료가 아닌 선불 크레딧에 기반합니다. 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50을 청구합니다. 오류는 무료이지만 성공적인 완료는 크레딧을 소모합니다. 서비스 가용성을 유지하려면 크립토를 통해 충전해야 합니다.
충전에는 USDT(TRC20) 또는 USDC(Base)를 지원합니다. 최소 입금 금액은 $20부터 시작합니다. 높은 티어에서 보너스가 적용됩니다: $50부터 +5%, $100부터 +10%, $200부터 +15%. 크레딧은 만료되지 않습니다. 대량 배치 실행 전에 잔액이 양수인지 확인하십시오. 현재 잔액과 최근 거래 내역을 확인하려면 대시보드를 확인하십시오.
스트리밍을 일반 응답과 혼동하기
SSE를 통한 스트리밍은 응답 스트림을 파싱하는 방식을 변경합니다. 표준 응답은 단일 JSON 개체를 반환합니다. 스트리밍은 여러 청크를 반환합니다. 정확한 토큰 사용량 통계를 얻으려면 마지막 청크를 처리해야 합니다.
스트리밍 구현 방식은 마지막 청크에 토큰 사용량이 포함됩니다. 스트림을 조기에 중단하면 이 데이터를 놓칠 수 있으므로, 클라이언트 라이브러리에서 SSE를 올바르게 지원하도록 확인하세요. 토큰이 생성되는 대로 표시해야 하는 실시간 애플리케이션에서는 이 부분이 매우 중요합니다. 스트리밍 설정이 잘못되면 텍스트가 불완전하거나 UI 상태가 깨질 수 있습니다.
tool_choice 구성 오류
잘못됨 tool_choice 설정값은 함수 호출이 의도대로 작동하지 못하게 할 수 있습니다. 특정 도구를 강제로 사용하거나 모델이 결정하도록 둘 수 있습니다. 잘못된 구성은 모델이 사용 가능한 함수를 무시하는 결과를 종종 초래합니다.
사용 tool_choice 모델이 도구들을 자동으로 호출할지 여부를 제어합니다. Set it to "auto" 유연한 결정 또는 엄격한 동작을 위해 도구 ID를 지정하세요. 함수 정의가 예상 스키마와 일치하는지 확인하세요. 이렇게 하면 모델이 존재하지 않는 함수를 호출할 때 런타임 오류를 방지할 수 있습니다. 프로덕션 배포 전 도구 정의를 철저히 테스트하세요.
json_object 모드 누락
Without response_format: {"type": "json_object"}, 모델은 마크다운 또는 일반 텍스트를 출력할 수 있습니다. 이는 엄격한 JSON을 기대하는 파서를 깨뜨립니다. 일관되고 파싱 가능한 출력을 보장하려면 JSON 모드를 활성화하세요.
이 기능은 구조화된 데이터가 필요한 하류 시스템과의 통합에 필수적입니다. 사후 처리 오버헤드를 크게 줄입니다. 클라이언트 코드에서 항상 출력 스키마를 검증하세요. 이는 모델의 occasional 한 환각에 대한 견고함을 보장합니다. 엔티티 추출이나 구성 파일 생성 시 이 모드를 사용하세요.
rate limit 놀라움
API는 키당 분당 300회 요청을 허용합니다. 이 한도를 초과하면 429 Too Many Errors 응답이 반환됩니다. 키당 동시 요청은 8개로 제한됩니다. 동시성 설정을 이에 맞게 계획하세요.
여러 프로세스를 실행하는 경우 동일한 키를 공유하거나 별도의 키를 생성하십시오. 각 계정당 활성 키는 하나만 지원합니다. 새 키는 이전 키를 대체합니다. 응답의 속도 제한 헤더를 모니터링하십시오. 재시도 로직에 지수 백오프를 구현하십시오. 이는 높은 트래픽 기간 동안 연쇄 실패를 방지합니다.
암호화폐 충전 지연
암호화폐 거래는 블록체인에서 확인에 시간이 걸릴 수 있습니다. 자금 전송 후 크레딧이 즉시 표시되지 않을 수 있습니다. 올바른 네트워크를 사용하세요: USDT는 TRC20, USDC는 Base를 사용해야 합니다. 잘못된 네트워크로 전송하면 자금이 손실됩니다.
충전 금액은 $20부터 $500까지입니다. 정확한 금액을 전송하거나 네트워크 수수료를 고려하세요. 블록체인 익스플로러에서 거래 해시를 확인하세요. 크레딧이 지연되면 거래 ID를 포함하여 지원팀에 문의하세요. 결제가 즉시 실패했다고 가정하지 마세요. 네트워크 혼잡기에는 인내심이 원활한 운영의 핵심입니다.
