변경 이력

AI Engine API(/v2/tire/tread·/v2/tire/sidewall과 각 precheck)의 공개 동작이 바뀔 때마다 이 페이지에 기록합니다. 요청·응답의 정확한 모양은 AI Engine API 레퍼런스가 기준입니다.

2.1.0 (2026-10-03)

공통

• 이미지 크기 상한을 넘으면 400 image_too_large를 돌려줍니다. 트레드·사이드월 모두 파일 50MB, 긴 변 16384px까지 받습니다.
• image_url은 최대 20초·50MB까지 내려받습니다. 시간 초과·연결 실패는 400 bad_image_url, 50MB 초과는 400 image_too_large입니다.
• Content-Type이 없거나 application/json·multipart/form-data가 아니면 400(code: null)입니다.
• 서버 오류(500)는 code: "internal_server_error"로 옵니다. 분기는 code로 하세요.
• precheck의 HTTP 상태 규칙을 정리했습니다. 사진을 검사했으면 200(analyzable·reason), 검사하지 못했으면 4xx, 서버 문제면 5xx입니다. 트레드 precheck에서 크기 상한을 넘은 사진은 이제 200 tread_not_found 대신 400 image_too_large입니다.

사이드월

• analysis_function에 새 항목 6종을 추가했습니다: brand, load_speed, dot.year, dot.week, display_orientation, text_regions. 요청한 항목만 응답에 들어가므로, 기존 요청(size·construction_type)의 응답 모양은 바뀌지 않습니다.
• 점(.)이 들어간 이름은 응답에서 중첩됩니다(dot.year → data.dot.year). 필드 블록은 {value, display, status, reason} 형식이며 status는 ok 또는 refused입니다.
• construction_type을 문서에 추가했습니다. 이전부터 응답에 있던 항목입니다.
• tire_size_not_found는 size를 요청했을 때만 돌려줍니다. size 없이 다른 필드만 요청하면, 읽지 못한 필드는 200 응답 안에서 refused로 옵니다.
• 사이드월 인식 모델을 업데이트했습니다. 응답 모양은 같지만 일부 사진의 판독 결과나 거절 여부가 달라질 수 있습니다. 상용 타이어는 판독 정확도를 보장할 수 없어 거절합니다.
• 문서 정정: data.dot을 문자열로 적었던 설명을 실제 모양(data.dot.year·data.dot.week)으로 바꿨습니다.

트레드

• 새 거절 코드 photo_too_dark·photo_too_blurry(400)를 추가했습니다. 밝은 곳에서, 초점을 맞춰 다시 촬영하도록 안내하세요.
• tread_pattern_unsupported(400)를 문서에 추가했습니다. 다시 촬영해도 같은 결과가 나오는 종결 코드입니다.
• 트레드 precheck의 reason에 photo_too_dark·photo_too_blurry·tread_pattern_unsupported를 추가했습니다.
• 문서 정정: 공개 샘플 사진의 예시 응답 값을 현재 엔진의 실제 응답으로 바꿨습니다.

이 페이지는 2.1.0부터 기록합니다.