---
title: "Preflight Nail Set"
method: POST
path: "/api/nail-sets/preflight"
---

# Preflight Nail Set

`POST /api/nail-sets/preflight`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/nail-sets/preflight`
- Auth: HTTP bearer

判定甲片图是否达 thumbnail 标准。best-effort:读图或 VLM 失败一律
fail-open(usable=true),绝不因预检故障挡住上传。

## Request body

- NailSetPreflightRequest: 调用者经 /api/uploads/standalone-presign 上传了甲片图,给出其原始 s3_key (校验必须落在调用者自己的 standalone 前缀下,防跨用户 key 注入)。
  - `nail_set_s3_key` string, nullable

## Response `200`

Successful Response

- NailSetPreflightResponse: 可试戴度预检结果 —— **只返回标记码,不返回任何文案**。前端用 i18n 把 `blocking_problems` 里的码 map 成本地化文字。usable=false 当且仅当存在阻断 问题;前端据此决定是否弹「建议先用 thumbnail」的引导(不阻断 try-on)。
  - `usable` boolean, required
  - `blocking_problems` string[], required
  - `nail_count` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)