변경 이력

분석 결과나 API 동작이 바뀐 날을 최신순으로 기록합니다. 항목 제목은 운영에 반영된 날짜이고, 소제목은 바뀐 제품과 판입니다. 예정된 항목은 맨 위에 두고 날짜 뒤에 "(예정)"을 붙입니다. 반영되면 실제 날짜로 고칩니다. 제품별 지금 판과 다음 예정은 버전 한눈에 보기에서 한 번에 볼 수 있습니다.

판 번호와 꼬리표

• 엔진 판: Dr.Tread 9.1처럼 두 자리로 부릅니다. 분석 결과가 한 장이라도 달라질 수 있는 변경이면 둘째 자리를 올립니다. 응답 모양이 같아도 정확도가 개선되면 분석 성공률과 측정값이 달라지므로 항목으로 기록합니다.
• 계약 판: AI Engine API 레퍼런스와 Report API 레퍼런스의 판 번호입니다(AI Engine API 2.x, Report API 1.x). 요청·응답 형식이 바뀔 때 올라가고, 엔진 정확도만 바뀔 때는 올라가지 않습니다.
• 꼬리표는 변경 종류, 영향 범위, 그때의 계약 판 순서로 붙습니다.

2026-10-29

Dr.Tread 9.1

트레드를 너무 가까이에서 찍어 홈이 몇 개만 크게 보이는 사진은 분석하지 않고 400 photo_too_close로 거절합니다. 요청·응답 형식은 그대로이고 에러 코드만 하나 늘었습니다. 한 걸음 물러서 트레드 폭 전체가 보이도록 다시 촬영하게 안내하세요. 정식 분석에서만 나오고 precheck의 reason에는 없습니다. precheck가 analyzable: true여도 정식 분석이 이 코드로 거절할 수 있습니다.

2026-10-20

Dr.Tread 9.0

마모도 예측, 어두운 사진을 포함한 트레드 검출, 홈 분할이 개선돼 이전에 실패하던 사진이 분석되고 같은 사진의 측정값도 달라질 수 있습니다. 요청·응답 형식은 그대로입니다. 측정값을 비교하는 기준이 있다면 이 날 이후 값으로 다시 잡으세요.

같은 판에서 트레드를 옆에서 너무 비스듬히 찍은 사진은 400 photo_too_oblique로 거절합니다. 타이어 정면에서 다시 촬영하게 안내하세요. 이 코드도 정식 분석에서만 나오고 precheck의 reason에는 없습니다.

2026-10-03

Dr.Tread 8.5

너무 어둡거나 흐린 트레드 사진은 분석하지 않고 400 photo_too_dark·400 photo_too_blurry로 거절합니다. 요청·응답 형식은 그대로이고 에러 코드가 늘었습니다. 밝은 곳에서, 초점을 맞춰 다시 촬영하게 안내하세요. 트레드 precheck의 reason에도 photo_too_dark·photo_too_blurry가 추가됐습니다.

tread_pattern_unsupported(400)는 문서에 추가했습니다. 다시 촬영해도 같은 결과가 나오는 종결 코드이며 precheck의 reason에도 나옵니다. 문서 정정으로 공개 샘플 사진의 예시 응답 값을 현재 엔진의 실제 응답으로 바꿨습니다.

Dr.Sidewall 4.1

사이드월에서 analysis_function으로 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입니다.

tire_size_not_found는 size를 요청했을 때만 돌려줍니다. size 없이 다른 필드만 요청하면 읽지 못한 필드는 200 응답 안에서 refused로 옵니다. 새 항목이 필요하면 요청에 추가하고, 판독 결과를 비교하는 기준이 있다면 이 날 이후 값으로 다시 잡으세요. 문서 정정: construction_type을 문서에 추가했습니다(이전부터 응답에 있던 항목입니다). data.dot을 문자열로 적었던 설명은 실제 모양(data.dot.year·data.dot.week)으로 바꿨습니다.

AI Engine API 2.1

트레드·사이드월 공통으로 요청 검증과 에러 응답 규칙이 정리됐습니다. 기존 호출이 정상 요청이면 응답 모양은 그대로이지만, 아래 거절 조건을 처리하는지 확인하세요.

• 이미지 크기 상한을 넘으면 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입니다.

Report API 1.3

트레드 4장만 촬영하는 템플릿 tire_4t_0s(사이드월 없음)를 쓸 수 있습니다. POST /reports의 template으로 지정합니다. 기존 템플릿(tire_4t_2s·tire_4t_4s)의 요청·응답은 바뀌지 않았고, 새 템플릿은 쓰는 쪽에서 고를 때만 적용됩니다.

리포트의 촬영 구성은 생성 시 템플릿으로 고정됩니다. upload_targets·slots[]·template.requirements[]는 구성에 포함된 슬롯만 담고, 구성에 없는 슬롯을 보내면 422 validation_error로 거절됩니다(새 에러 코드는 없습니다). 트레드 전용 리포트의 /content에는 sidewall_spec 섹션이 없고 render_data.sidewall_specs는 빈 배열이므로, 섹션은 section_id로 렌더링하고 개수를 고정하지 마세요. OpenAPI 스키마에서 template의 default 키워드를 뺐습니다. 생성 클라이언트가 값을 자동으로 채우지 않게 하려는 것이고, 생략하면 서버가 tire_4t_2s를 적용하는 동작은 그대로입니다. 자세한 내용은 이미지 수집을 참고하세요.

2026-07-22

Report API 1.2

파트너 화면에서 리포트를 직접 그릴 수 있도록 응답을 두 계약으로 나눴습니다. GET /reports/{id}는 측정값·분석 결과·상태를 담은 객관 데이터 report.v1이고, 새로 생긴 GET /reports/{id}/content는 문구·판정·섹션을 담은 report-content.v1입니다. 콘텐츠 응답은 판정 규칙과 문구 판(ruleset_version, copy_version)을 함께 알려 주며, 발급된 콘텐츠 리비전의 응답은 바뀌지 않습니다. 자체 렌더링을 하려면 리포트 데이터와 콘텐츠를 참고해 두 응답을 함께 쓰세요.

Report API 1.1

Pre-Signed 업로드 타깃마다 고유한 asset_id가 발급되고, POST /reports/{id}/images는 이 asset_id와 슬롯 참조를 함께 받습니다. 슬롯만 보내던 이전 요청 형태는 더 이상 지원하지 않으므로 이미지 등록 코드를 고쳐야 합니다. 만료되거나 재촬영한 이미지는 POST /reports/{id}/upload-targets로 새 타깃을 발급받으세요.

리포트 폐기(DELETE /reports/{id})가 추가됐습니다. 반복 호출은 멱등이고, 폐기된 리포트는 409 report_discarded를 돌려줍니다. POST /reports의 Idempotency-Key는 리포트가 변경 가능한 동안 같은 키·본문의 재시도에 최초 응답을 그대로 돌려줍니다.

2026-06

AI Engine API 2.0 · Report API 1.0

AI Engine API 2.0(/v2/tire/tread·/v2/tire/sidewall과 각 precheck)과 Report API 1.0의 계약을 공개했습니다. 이후 변경은 위 항목에 기록합니다. 엔진 판(Dr.Tread·Dr.Sidewall)은 2026-10-03의 Dr.Tread 8.5·Dr.Sidewall 4.1부터 기록합니다.