どんな機能か。 あらゆる側面を網羅した自然言語の肌レポートを、高精度な AI 肌分析とプロフェッショナルなスキンケア参照データベースをもとに大規模言語モデルが生成します。モデルは肌について推測するのではありません — 実測・定量化された肌指標と実際の検出マスクを解釈し、プロのスキンケアデータと比較したうえで、完全なレポートを llm_results.json で返します。
レポートの各項目に必要な dst_actions。 レポートの充実度は、リクエストする機能しだいです。dst_actions は必須で、1 つのリクエストで HD 機能と SD 機能を混在させることはできません — どちらか一方の系統を選んでください。
| レポートの項目 | V2.1 機能 | 返される領域 |
|---|---|---|
| 顔の輪郭と各顔部位の位置特定 | pf_camera_kit: true | — |
| 肌タイプ | hd_skin_type | whole、t_zone、u_zone |
| T ゾーンと U ゾーンの比較 | hd_skin_type | t_zone、u_zone |
| おでこのしわと眉間のしわ | hd_wrinkle | forehead、glabellar |
| 目尻のしわとほうれい線 | hd_wrinkle | crowfeet、nasolabial |
| 毛穴の分布 | hd_pore | forehead、nose、cheek、whole |
| 肌のなめらかさ | hd_texture | whole |
パラメータ
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
language | 文字列 enum | enu | enu cht jpn kor fra deu esn ita ptb ind ara |
tone | 文字列 enum | warm | warm | direct — どちらのトーンでもプロフェッショナルな語り口を維持します |
country | 文字列 | — | レポートに気候・季節の情報を加えます |
city | 文字列 | — | レポートに気候・季節の情報を加えます |
すべてのデフォルト値を受け入れる場合は "advanced_report": {} を送信してください。レポートが不要な場合は、オブジェクトをまるごと省略します。
- AI タスクを作成する
# Skin Analysis with Advanced Skin Report
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis-report" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"src_file_url": "https://your-cdn.example.com/customer-001.jpg",
"dst_actions": ["hd_skin_type", "hd_wrinkle", "hd_pore", "hd_texture"],
"format": "zip",
"pf_camera_kit": true,
"advanced_report": {
"language": "cht",
"tone": "direct",
"country": "Taiwan",
"city": "Taipei"
}
}'# Same call, every report default (enu / warm, no climate context)
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis-report" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"src_file_id": "your-uploaded-file-id",
"dst_actions": ["hd_skin_type", "hd_wrinkle", "hd_pore", "hd_texture"],
"pf_camera_kit": true,
"advanced_report": {}
}'- レポートとレコメンドをポーリングする
実行のたびに BasicRunTaskResponseV2 がただちに返されます。返された id でタスクをポーリングしてください。レポートとレコメンドは llm_results.json に届けられます。
# 1. Run the task and capture the task id
TASK_ID=$(curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis-report" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{ ... }' | jq -r '.data.task_id')
# 2. Poll until task_status is "success"
curl -sS -H "Authorization: Bearer $API_KEY" \
"$BASE_URL/s2s/v2.1/task/skin-analysis-report/$TASK_ID"task_status は running → success | error と遷移します。format: zip の場合、results.url は 2 時間有効なダウンロードリンクで、ZIP には score_info.json とすべての検出画像を収めた skinanalysisResult フォルダが入っています。format: json の場合、results.output にスコアがレスポンス本文へ直接返されます。
- リクエストフィールド早見表
| フィールド | 必須 | 説明 |
|---|---|---|
src_file_id / src_file_url | はい（いずれか 1 つ） | 入力画像。BasicRunTaskV2 に準拠 |
dst_actions | はい | HD 機能または SD 機能 — 混在は不可 |
format | いいえ | zip（デフォルト）| json — レスポンススキーマが異なります |
pf_camera_kit | いいえ | V2.1 で追加。顔の輪郭と各顔部位の位置特定 |
miniserver_args | いいえ | マスクオーバーレイと HD 毛穴・しわの背景の制御 |
advanced_report | いいえ | 指定 → レポートを出力。{} → すべてデフォルト値。省略 → なし |
product_recommendation | いいえ | 指定 → レコメンドを出力。catalog_id が必要 |
解像度。 すべての出力画像は長辺 2560 px までに上限設定され、入力は自動的にリサイズされます。enable_mask_overlay が false の場合、生のマスクが .png で返されるため、合成はお客様側で行う必要があります — 入力解像度を確認し、長辺が 2560 px を超える場合は表示サイズを 2560 px 基準で設計してください。