多项目教练API

为跑步者、骑行爱好者、游泳者和铁人三项运动员创建个性化训练计划的AI教练。该技能提供训练计划、表现指标、AI教练和计划调整功能。由Transition提供技术支持。

身份验证

需要身份验证的端点需要设置TRANSITIONAPIKEY环境变量。在每次请求中将其作为X-API-Key标头传递。如果未设置，请告知用户在Transition应用的设置>API密钥中生成一个。

基础URL： https://api.transition.fun

免费端点（无需身份验证）

每日训练

生成随机结构化训练。每次请求返回不同的训练内容。

bash
curl https://api.transition.fun/api/v1/wod?sport=run&duration=45

参数：

• - sport — run（跑步）、bike（骑行）、swim（游泳）或strength（力量训练）（默认：run）
• duration — 分钟，10-300（默认：45）

响应：
json
{
date: 2026-02-09,
sport: run,
name: 节奏训练,
description: 通过持续节奏训练建立有氧耐力,
duration_minutes: 45,
intensity: 中等,
segments: [
{name: 热身, duration_minutes: 9, intensity: 轻松, description: 轻松慢跑热身},
{name: 节奏跑, duration_minutes: 27, intensity: 中等, description: 以舒适但吃力的配速保持稳定节奏},
{name: 放松, duration_minutes: 9, intensity: 轻松, description: 轻松慢跑放松}
]
}

需要身份验证的端点

获取训练计划

检索指定日期范围内的计划训练。

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15

参数：

• - start — 开始日期（YYYY-MM-DD格式，必填）
• end — 结束日期（YYYY-MM-DD格式，必填）
• start和end之间的最大范围为90天。

获取训练详情

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts/123

生成训练计划

触发AI为用户的训练计划生成训练内容。

bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
-H Content-Type: application/json \
https://api.transition.fun/api/v1/workouts/generate

调整训练计划

根据近期表现或日程变化调整训练计划。

bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
-H Content-Type: application/json \
-d {reason: 比赛周末后感到疲劳} \
https://api.transition.fun/api/v1/workouts/adapt

检查生成状态

轮询检查训练生成/调整是否完成。

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts/status

表现管理图表（PMC）

获取CTL（体能）、ATL（疲劳）和TSB（状态）数据。

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/performance/pmc

表现统计数据

获取FTP、阈值配速、心率区间和其他指标。

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/performance/stats

AI教练对话

与AI耐力教练对话。返回流式响应（SSE）。

bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
-H Content-Type: application/json \
-d {message: 我今天应该做间歇训练还是休息？} \
https://api.transition.fun/api/v1/coach/chat

对话历史

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/coach/history

运动员档案

bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/profile

推送训练到Garmin

bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts/123/push-garmin

速率限制

读取端点： 训练、指标、档案、历史
AI端点： 教练对话、调整、生成

速率限制错误返回HTTP 429状态码，并附带说明超出哪个限制的消息。

给代理的提示

1. 1. 在推荐高强度训练前检查疲劳状态。 调用GET /api/v1/performance/pmc并查看TSB（训练压力平衡）。如果TSB低于-20，运动员可能处于疲劳状态——建议进行较轻松的训练或休息。

1. 2. 谨慎使用调整功能。 计划调整会使用AI重新生成整个训练计划。仅在运动员明确要求更改或有重要原因（受伤、日程变化、比赛日期变更）时触发。

1. 3. 为临时用户使用免费WOD端点。 如果有人只想快速获取训练内容而不注册，使用GET /api/v1/wod。无需API密钥。

1. 4. 训练生成是异步的。 调用POST /workouts/generate或POST /workouts/adapt后，轮询GET /workouts/status直到返回就绪状态，然后获取训练内容。

1. 5. 所有日期参数的格式始终为YYYY-MM-DD。