전체 응답 읽기
실패 상태의 경우 비밀 정보를 제거한 뒤 HTTP 코드, 헤더, 오류 본문 및 요청 ID를 보존하세요. 이 정보로 잘못된 요청, 접근 거부, 일시적 문제를 구분할 수 있습니다.
원시 서비스 응답만을 사용자 메시지로 노출하지 마세요. 작업을 설명하되 운영자를 위한 진단 세부 정보는 유지하세요.
실패한 응답 검사
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'실패 분류
- 4xx는 일반적으로 키, 입력 데이터 또는 접근 권한을 수정해야 함을 뜻합니다.
- 429에서는 제한 기간을 준수하고 공격적인 재시도를 피해야 합니다.
- 5xx 및 네트워크 실패에는 지수 백오프와 지터가 적용된 제한된 재시도를 사용하세요.
안전한 재시도
일시적인 실패만, 그리고 제품에서 작업의 멱등성을 보장할 수 있을 때만 재시도하세요. 생성 작업에서는 이중 청구나 아티팩트 중복을 막기 위해 클라이언트 요청 ID를 유지하세요.
스트리밍에서는 첫 델타 이전의 오류와 일부 출력 이후의 중단을 구분하세요. 후자는 새 응답으로 조용히 대체할 수 없습니다.