{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-CN/reference/ai_teeth_whitening.yaml","sidebar":"sidebar-@l10n/zh-CN/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-CN/reference/ai_teeth_whitening.yaml","settings":{"baseUrlPath":"/zh-cn/reference/ai_teeth_whitening"},"disableAutoScroll":true,"seo":{"title":"AI 牙齿美白","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 牙齿美白","version":"","description":"# 概览\n**AI 牙齿美白接口**\n\nAI 牙齿美白接口提供先进的自动化方案，把照片里的笑容打理得更出彩。它用智能图像处理，把牙齿自然、准确地提亮，几秒钟就出精致专业的效果。\n\n\n\n\n\n\n**它是怎么去掉照片里发黄牙齿的**\n\n**智能美白** \n接口会自动检测牙齿，套用看着自然的白牙效果，画面不会假。\n\n**强度可调** \n内置调节功能，美白程度由您掌握：从微微提亮，到上镜级的明显白皙。\n\n\n\n**主要特性**\n\n**又快又省事** \n几秒钟就能让笑容明显更亮。\n\n**AI 检测精准** \n先进的检测只改动牙齿，整体观感真实、协调。\n\n**美白强度可调** \n按您喜欢的效果微调美白力度。\n\n**先进算法，效果自然**\n\nAI 牙齿美白接口采用精密算法，准确识别牙齿，套用出来的美白效果贴近真实。您可以微调强度，做出含蓄自然的改善，让最终效果看着真实、顺眼。\n\n---\n\n## 接入指南\n\n* 拍一张自拍\n\n * 正对镜头，光线充足。\n * 也可以用 JS Camera Kit 拍照。\n\n* 通过 ***/s2s/v2.0/file*** 接口取得上传 URL 与文件 ID\n\n 用 File 接口响应中返回的上传 URL 上传以下文件：\n * 您的自拍照片\n\n* 执行 AI 任务 ***/s2s/v2.0/task/teeth-whiten***\n\n 用文件 ID 或图片 URL 作为输入源执行 AI 任务，特效参数按需要设置。\n\n* 轮询任务状态\n\n 用返回的 **task\\_id** 监控任务进度。 \n 轮询 **GET /s2s/v2.0/task/teeth-whiten/{task_id}** 查看引擎状态。 \n 任务完成之前会一直处于 **“running”** 状态，这一阶段不消耗点数。\n\n\n\n* **用法演示**\n\n\n\n\n\n\n\n## 文件规格与错误码\n* 支持的格式与尺寸\n\n|类型|支持尺寸|支持文件大小|支持格式|\n| ---- | ---- | ---- | ---- |\n|AI 牙齿美白|自拍图片：
* 长边 ≤ 1920 px
* 短边 ≥ 320 px |< 10MB|jpg/png|\n\n\n* 错误码\n\n|错误码|说明|\n| ---- | ---- |\n| error_exceed_max_image_size | 图片长边超过 1920 像素 |\n|error_below_min_image_size|图片宽或高小于 320 像素，尺寸过小，无法使用|\n|error_face_position_invalid|脸部需完整可见，不能被裁掉一部分|\n|error_face_position_too_small|照片中的人脸过小，无法准确分析|\n|error_face_position_out_of_boundary|脸部过大，或部分超出照片边缘|\n|error_insufficient_lighting|光线太暗，分析起来很困难|\n|error_face_angle_invalid|脸部角度不太对。正脸拍摄时，头部偏离正向请在 10 度以内；侧脸拍摄时，角度应大于 15 度|\n\n* 运行环境与依赖\n\n| 示例代码语言 / 工具 | 建议运行时版本 |\n|---|---|\n| cURL | - bash >= 3.2 - curl >= 7.58 (modern TLS/HTTP support) - jq >= 1.6 (robust JSON parsing) |\n| Node.js (JavaScript) | Node >= 18 (for global fetch) |\n| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 |\n| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |\n| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |\n\n---\n\n## 点数消耗\n\n| AI 功能 | 消耗点数 |\n|---|---|\n| AI 牙齿美白 V1.0 | 1 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.217.126"},"lang":"zh-CN","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-cn/reference/ai_teeth_whitening","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}