コンテンツにスキップ

体組成再構成予測API

予想される脂肪減少と筋肉増加の軌跡および成功する再構成の確率を推定し、4/8/12週の予測ブロックを含みます。

エンドポイント

  • GET /api/v1/fitness/body-recomp-forecast
  • POST /api/v1/fitness/body-recomp-forecast/post

パラメータ

名前 型 必須 In 説明
current_weight 数値 (35-300) はい クエリ/ボディ 現在の体重 (kg)。
body_fat_percentage 数値 (5-60) はい クエリ/ボディ 現在の体脂肪率。
calorie_intake 数値 (800-6000) はい クエリ/ボディ 1日の平均摂取量。
protein_intake 数値 (40-450) はい クエリ/ボディ 1日のタンパク質 (グラム)。
training_days 整数 (0-7) はい クエリ/ボディ 1週間の抵抗運動日数。
experience_level 文字列 はい クエリ/ボディ beginner,intermediate,advanced,elite。
lang 文字列 いいえ クエリ レスポンス言語 (en,es,de,fr,pt,ja,hi,ar)。

このエンドポイントを使用する理由

  • 静的な摂取/トレーニングデータを、予測された再構成の結果に変換する。
  • コーチング介入のために、再構成の確率に基づいてユーザーを優先する。
  • 遵守と定着を改善するためのタイムラインの可視化を提供する。

開始する

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast?current_weight=84&body_fat_percentage=24&calorie_intake=2350&protein_intake=165&training_days=4&experience_level=intermediate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "current_weight": 84,
    "body_fat_percentage": 24,
    "calorie_intake": 2350,
    "protein_intake": 165,
    "training_days": 4,
    "experience_level": "intermediate"
  }'

レスポンスの例

Info

このレスポンスの例は、デモンストレーションのみを目的としています。 このエンドポイントに対してライブリクエストを作成して、完全でリアルタイム、および潜在的により豊富なJSON構造を受信してください。

{
  "current_weight_kg": 84.0,
  "body_fat_percentage": 24.0,
  "calorie_intake": 2350,
  "protein_intake_g": 165.0,
  "training_days": 4,
  "experience_level": "intermediate",
  "experience_level_label": "Intermediate",
  "estimated_fat_loss_vs_muscle_gain_ratio": {
    "fat_loss_kg_per_week": 0.23,
    "muscle_gain_kg_per_week": 0.13,
    "fat_to_muscle_ratio": 1.77,
    "ratio_label": "balanced_recomp",
    "ratio_label_text": "Balanced recomp"
  },
  "recomp_probability_score": {
    "score": 73,
    "band": "moderate",
    "band_label": "Moderate",
    "insight": "Good potential with consistency."
  },
  "timeline_projection": [
    {
      "week": 4,
      "projected_weight_kg": 83.6,
      "projected_body_fat_percent": 23.2,
      "estimated_fat_mass_change_kg": -0.92,
      "estimated_lean_mass_change_kg": 0.52
    }
  ],
  "strategy_adjustment_advice": ["Keep protein high", "Maintain progressive overload"],
  "metabolic_context": {
    "estimated_maintenance_calories": 2720,
    "daily_energy_gap": -370,
    "protein_g_per_kg": 1.96
  },
  "confidence_score": 84,
  "summary": "Consistent execution can deliver measurable recomposition.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "4b2ad1f68d3dc50a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_body_recomp_forecast",
    "response_language": "en"
  }
}

市場でのポジショニング

高いエンゲージメントプラットフォームやプレミアムフィットネス製品に適しており、ユーザーは、明確な確率ベースの進捗予測を必要とします。

注意

体重、体脂肪率、カロリー、タンパク質、およびトレーニング日数などの範囲内のすべての入力に対して厳格な検証が行われます。

推奨されるエンドポイント