コンテンツへスキップ

歯ホワイトニング

概要

歯ホワイトニング API

歯ホワイトニング API で、写真内の歯を明るくします。

写真内の黄ばんだ歯を除去する方法

スマートホワイトニング
API は自動的に歯を検出し、ホワイトニング効果を適用します。

調整可能なレベル
ホワイトニングの度合いを調整できます。

主な機能

迅速な強化
数秒で歯を明るくします。

正確な AI 検出
歯のみが修正されます。

調整可能なホワイトニング強度
ホワイトニングの強度を調整できます。

自然な結果

歯ホワイトニング API は、歯を識別してホワイトニング効果を適用します。強度を調整できます。


統合ガイド

  • セルフィーを撮影する

    • 適切な照明の下でカメラに直接向かいます。
    • JS Camera Kit を使用して写真をキャプチャします。
  • /s2s/v2.0/file API を介してアップロード URL とファイル ID を取得する

    ファイル API レスポンスで返されたアップロード URL を使用して、以下のファイルをアップロードします。

    • セルフィー写真
  • AI タスク /s2s/v2.0/task/teeth-whiten を実行する

    入力ソースとしてファイル ID または画像 URL を使用して AI タスクを実行します。効果パラメータを必要に応じて設定します。

  • タスクステータスのポーリング

    返された task_id を使用してタスクの進捗を監視します。
    GET /s2s/v2.0/task/teeth-whiten/{task_id} をポーリングしてエンジンのステータスを確認します。
    タスクは完了するまで “running” 状態のままです。タスク実行中はユニットは消費されません。

  • 使用例のデモ

ファイル仕様とエラー

  • 対応フォーマットと寸法
タイプ対応寸法対応ファイルサイズ対応フォーマット
AI Teeth Whiteningセルフィー画像:
* 長辺 ≤ 1920 px
* 短辺 ≥ 320 px
< 10MBjpg/png
  • エラーコード
エラーコード説明
error_exceed_max_image_size画像の長辺が 1920 ピクセルを超える場合
error_below_min_image_size画像の幅または高さが 320 ピクセル未満の場合、使用するには小さすぎます
error_face_position_invalid画像内で顔全体が完全に可視であり、一部が切り取られていない必要があります
error_face_position_too_small写真内の顔が小さすぎて適切に分析できません
error_face_position_out_of_boundary顔が大きすぎるか、写真の端の一部が外れています
error_insufficient_lighting照明が暗すぎて分析が困難です
error_face_angle_invalid顔の角度が適切ではありません。正面を向いた撮影では、頭を正面から 10 度以内に保ってください。横を向いた撮影では、角度は 15 度以上である必要があります
  • 環境と依存関係
サンプルコード言語 / ツール推奨ランタイムバージョン
cURL- bash >= 3.2
- curl >= 7.58 (モダンな TLS/HTTP サポート)
- jq >= 1.6 (堅牢な JSON パーシング)
Node.js (JavaScript)Node >= 18 (グローバル fetch 用)
JavaScript- Chrome / Edge >= 80
- Firefox >= 74
- Safari >= 13.1
PHPPHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json
PythonPython >= 3.10 (f-strings 用), requests >= 2.20.0
JavaJava 11+ (HttpClient 用), Jackson Databind >= 2.12.0

ユニット消費量

AI 機能消費ユニット
AI Teeth Whitening V1.01

OpenAPI記述をダウンロード
言語
サーバー
https://yce-api-01.makeupar.com