자주 발생하는 오류

대부분 키, 중복 /v1, 잘못된 모델 ID, 잔액, 속도 제한, timeout에서 발생합니다. 전체 오류와 request ID를 보관하세요.

missing_api_key/Invalid API key: Bearer 헤더와 키를 확인하세요.
/v1/v1/messages 또는 404: SDK가 자동 추가한 경로를 수정하세요.
pricing_not_found, 402, 429, 스트림 중단은 모델, 잔액, 재시도, timeout을 점검하세요.

관련 가이드

dashboard
model catalog
ready-made version here
도구 결과에 담긴 이미지(tool_result 또는 tool 역할 메시지)는 일반 메시지의 이미지와 똑같이 모델에 전달됩니다. 모델이 보지 못한다면 해당 모델의 이미지 지원 여부를 확인하고 클라이언트를 업데이트하세요.

먼저 최소 텍스트 요청으로 연결을 확인한 다음 스트리밍, 도구 호출, 이미지와 같은 고급 기능을 추가하세요. API 키를 공개 코드나 브라우저 프런트엔드에 넣지 마세요.