风帆服务

风帆服务对外只开放一个能力：fengfan-service，用于查询风帆漫剧素材分集。内部的 material.query 只是实现行为，不是独立授权项。

能力信息

字段	值
能力 key	`fengfan-service`
能力名称	风帆服务
唯一行为	漫剧素材查询
执行方式	同步，不创建平台任务
授权方式	显式授予能力 key
输出	`data.episodes` 分集列表

授权 fengfan-service 即可使用当前唯一的漫剧素材查询行为。后续若新增独立对外能力，应使用新的能力 key 单独授权。

调用入口

使用当前 API Key 调用动作：


POST /api/open/v1/capabilities/fengfan-service/execute
Authorization: Bearer <sk-funclaw-api-key>
Content-Type: application/json

按媒体 ID 查询：


{
  "input": {
    "mediaId": 88
  }
}

按媒体名称查询：


{
  "input": {
    "mediaName": "空军佬"
  }
}

mediaId 与 mediaName 必须二选一。ID 必须为正整数，名称按精确名称匹配；不接受额外字段或字符串形式的 ID。

响应


{
  "capabilityKey": "fengfan-service",
  "message": "SUCCEEDED",
  "code": 200,
  "data": {
    "episodes": [
      {
        "mediaId": 88,
        "mediaName": "空军佬",
        "episodeId": 100,
        "funEpisodeId": 101,
        "name": "第1集",
        "num": 1,
        "still": "https://example.com/cover.jpg",
        "downloadUrl": "https://example.com/episode.mp4"
      }
    ]
  }
}

字段	说明
`episodes[].num`	分集序号。
`episodes[].episodeId` / `funEpisodeId`	分集标识。
`episodes[].still`	分集静帧地址，可能为空。
`episodes[].downloadUrl`	上游提供的临时下载地址，应尽快使用，不应持久化为永久地址。

错误处理

HTTP 状态	reason	说明
`400`	`FENGFAN_MATERIAL_QUERY_INVALID`	输入未满足二选一或字段类型要求。
`403`	`open capability not granted`	当前 Key 未被显式授予 `fengfan-service` 能力。
`502`	`FENGFAN_MANJU_EPISODES_UNAVAILABLE`	上游暂不可用或未返回可用分集。