# 视频详情

按 BV 号取一个 B 站视频的完整数据。要取它的评论用 bilibili_video_comments_v1,要按关键词找视频用 bilibili_search_videos_v1。

ID: native-http:social.bilibili.video.detail · Region: cn · Status: unknown

catalog_version: 5c920c774a55e44d7e8c709143b88a18b8b2afcef91a5d19a8c9ae5d565d9077
updated_at: 2026-10-21T12:06:16.523771+00:00

缓存资料；当前可用状态待核实。

按 BV 号取一个 B 站视频的完整数据。要取它的评论用 bilibili_video_comments_v1,要按关键词找视频用 bilibili_search_videos_v1。

历史数据以数据集发布版本定义覆盖周期；实时读取反映请求时资料，不保证覆盖全部记录。

Docs: https://docs.asklear.cn/capabilities/native-http%3Asocial.bilibili.video.detail

## POST /v1/native/social/bilibili/videos/detail

native · unknown · api_key

REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。

按 BV 号取一个 B 站视频的完整数据。要取它的评论用 bilibili_video_comments_v1,要按关键词找视频用 bilibili_search_videos_v1。

按成功请求计费，每次请求计一次；max_credits 限制本次费用上限。

恢复同一次原生请求时复用原 Idempotency-Key。

等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。

### Input schema / 输入契约

```json
{
  "$defs": {
    "Schema1": {}
  },
  "additionalProperties": false,
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "video_id": {
          "description": "作品id/Video id",
          "maxLength": 64,
          "minLength": 1,
          "pattern": "^[A-Za-z0-9_-]+$",
          "type": "string"
        }
      },
      "required": [
        "video_id"
      ],
      "type": "object"
    },
    "max_credits": {
      "anyOf": [
        {
          "maximum": 1000000000,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "task_query": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.",
          "maxLength": 300
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}
```

### Synthetic request / 合成请求

```json
{
  "input": {
    "video_id": "sph_example"
  }
}
```

### Response schema / 响应契约

```json
{
  "$defs": {
    "Schema1": {},
    "Schema2": {
      "properties": {
        "api_name": {
          "type": "string"
        },
        "credits_charged": {
          "minimum": 0,
          "type": "integer"
        },
        "latency_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_input": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "video_id": {
                  "maxLength": 64,
                  "minLength": 1,
                  "pattern": "^[A-Za-z0-9_-]+$",
                  "type": "string"
                }
              },
              "required": [
                "video_id"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "api_name",
        "request_id",
        "latency_ms",
        "credits_charged",
        "next_input"
      ],
      "type": "object"
    }
  },
  "properties": {
    "data": {
      "additionalProperties": true,
      "description": "Known optional fields from sanitized offline fixtures; conditional fields may be null. Additional business fields are retained.",
      "properties": {
        "code": {
          "type": [
            "integer",
            "null"
          ]
        },
        "data": {
          "additionalProperties": true,
          "properties": {
            "code": {
              "type": [
                "integer",
                "null"
              ]
            },
            "data": {
              "additionalProperties": true,
              "properties": {
                "bvid": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "desc": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "desc_v2": {
                  "items": {
                    "additionalProperties": true,
                    "properties": {
                      "type": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "type": [
                    "array",
                    "null"
                  ]
                },
                "duration": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "owner": {
                  "additionalProperties": true,
                  "properties": {
                    "mid": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "pages": {
                  "items": {
                    "additionalProperties": true,
                    "properties": {
                      "duration": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "page": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "type": [
                    "array",
                    "null"
                  ]
                },
                "pubdate": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "stat": {
                  "additionalProperties": true,
                  "properties": {
                    "danmaku": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "favorite": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "reply": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "view": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  },
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "tname": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "ugc_season": {
                  "additionalProperties": true,
                  "properties": {
                    "sections": {
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "episodes": {
                            "items": {
                              "additionalProperties": true,
                              "properties": {
                                "arc": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "desc": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "duration": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "pubdate": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "stat": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "danmaku": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        },
                                        "reply": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        },
                                        "view": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        }
                                      },
                                      "type": [
                                        "object",
                                        "null"
                                      ]
                                    },
                                    "title": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    }
                                  },
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "bvid": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "page": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "duration": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "page": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "pages": {
                                  "items": {
                                    "additionalProperties": true,
                                    "properties": {
                                      "duration": {
                                        "type": [
                                          "integer",
                                          "null"
                                        ]
                                      },
                                      "page": {
                                        "type": [
                                          "integer",
                                          "null"
                                        ]
                                      }
                                    },
                                    "type": [
                                      "object",
                                      "null"
                                    ]
                                  },
                                  "type": [
                                    "array",
                                    "null"
                                  ]
                                },
                                "title": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": [
                                "object",
                                "null"
                              ]
                            },
                            "type": [
                              "array",
                              "null"
                            ]
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "type": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          }
                        },
                        "type": [
                          "object",
                          "null"
                        ]
                      },
                      "type": [
                        "array",
                        "null"
                      ]
                    },
                    "stat": {
                      "additionalProperties": true,
                      "properties": {
                        "danmaku": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "reply": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "view": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        }
                      },
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "type": [
                    "object",
                    "null"
                  ]
                }
              },
              "type": [
                "object",
                "null"
              ]
            },
            "message": {
              "type": [
                "string",
                "null"
              ]
            },
            "ttl": {
              "type": [
                "integer",
                "null"
              ]
            }
          },
          "type": [
            "object",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "meta": {
      "$ref": "#/$defs/Schema2"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Synthetic response / 合成响应

```json
{
  "data": {
    "code": 200,
    "data": {
      "code": 0,
      "data": {
        "bvid": "BV15v5Q63Edy",
        "desc": "长期用扫地机越拖越脏、毛发缠绕、乱撞卡困、基站发霉发臭？其实不是机器不行，是你没搞懂选购核心参数！\n实测对比近 50 款热门机型，拆解扫地机三大选购关键：清洁能力、智能避障、基站自清洁。从吸力滚刷拖布配置，到 LDS/dTOF 导航避障，再到热水洗拖布、烘干除菌、可拆卸基站底盘避坑要点一次性讲透。\n按 2000-3000 元、3000-4000 元、4000 元以上价位，深度测评科沃斯、石头、友望、美的、追觅、云鲸等 10 款热门机型，不同预算、不同户型直接对号入座，帮你闭眼选到长期耐用不踩坑的扫地机！",
        "desc_v2": [
          {
            "type": 1
          }
        ],
        "duration": 821,
        "owner": {
          "mid": 3546873430281180,
          "name": "懒人测评社"
        },
        "pages": [
          {
            "duration": 821,
            "page": 1
          }
        ],
        "pubdate": 1778740178,
        "stat": {
          "danmaku": 73,
          "favorite": 7596,
          "reply": 329,
          "view": 188576
        },
        "title": "【618推荐】2026年高性价比扫地机器人推荐 | 连续测评三个月，敢讲真话，告诉你谁更靠谱！| 10款扫地机横评 追觅/友望/小米/云鲸/美的/石头/科沃斯",
        "tname": "",
        "ugc_season": {
          "sections": [
            {
              "episodes": [
                {
                  "arc": {
                    "desc": "",
                    "duration": 821,
                    "pubdate": 1778740178,
                    "stat": {
                      "danmaku": 73,
                      "reply": 329,
                      "view": 188576
                    },
                    "title": "【618推荐】2026年高性价比扫地机器人推荐 | 连续测评三个月，敢讲真话，告诉你谁更靠谱！| 10款扫地机横评 追觅/友望/小米/云鲸/美的/石头/科沃斯"
                  },
                  "bvid": "BV15v5Q63Edy",
                  "page": {
                    "duration": 821,
                    "page": 1
                  },
                  "pages": [
                    {
                      "duration": 821,
                      "page": 1
                    }
                  ],
                  "title": "【618推荐】2026年高性价比扫地机器人推荐 | 连续测评三个月，敢讲真话，告诉你谁更靠谱！| 10款扫地机横评 追觅/友望/小米/云鲸/美的/石头/科沃斯"
                }
              ],
              "title": "正片",
              "type": 1
            }
          ],
          "stat": {
            "danmaku": 455,
            "reply": 1361,
            "view": 827187
          },
          "title": "扫地机"
        }
      },
      "message": "OK",
      "ttl": 1
    }
  },
  "meta": {
    "api_name": "social.bilibili.video.detail",
    "credits_charged": 3,
    "latency_ms": 12,
    "next_input": null,
    "request_id": "asklear-example"
  }
}
```

- data (object): Known optional fields from sanitized offline fixtures; conditional fields may be null. Additional business fields are retained.
- data.code (integer|null): 暂无字段说明
- data.data (object|null): 暂无字段说明
- data.data.code (integer|null): 暂无字段说明
- data.data.data (object|null): 暂无字段说明
- data.data.data.bvid (string|null): 视频ID（如有）。
- data.data.data.desc (string|null): 描述（如有）。
- data.data.data.desc_v2 (array|null): 暂无字段说明
- data.data.data.duration (integer|null): 时长（如有）。
- data.data.data.owner (object|null): 暂无字段说明
- data.data.data.owner.mid (integer|null): 作者 ID（如有）。
- data.data.data.owner.name (string|null): 作者名称（如有）。
- data.data.data.pages (array|null): 暂无字段说明
- data.data.data.pubdate (integer|null): 发布时间（如有）。
- data.data.data.stat (object|null): 暂无字段说明
- data.data.data.stat.danmaku (integer|null): 弹幕数（如有）。
- data.data.data.stat.favorite (integer|null): 收藏数（如有）。
- data.data.data.stat.reply (integer|null): 评论数（如有）。
- data.data.data.stat.view (integer|null): 播放数（如有）。
- data.data.data.title (string|null): 标题（如有）。
- data.data.data.tname (string|null): 类目（如有）。
- data.data.data.ugc_season (object|null): 暂无字段说明
- data.data.data.ugc_season.sections (array|null): 暂无字段说明
- data.data.data.ugc_season.stat (object|null): 暂无字段说明
- data.data.data.ugc_season.stat.danmaku (integer|null): 暂无字段说明
- data.data.data.ugc_season.stat.reply (integer|null): 暂无字段说明
- data.data.data.ugc_season.stat.view (integer|null): 暂无字段说明
- data.data.data.ugc_season.title (string|null): 暂无字段说明
- data.data.message (string|null): 暂无字段说明
- data.data.ttl (integer|null): 暂无字段说明
- meta (object): 暂无字段说明
- meta.api_name (string): 暂无字段说明
- meta.request_id (string): 暂无字段说明
- meta.latency_ms (integer): 暂无字段说明
- meta.credits_charged (integer): 暂无字段说明
- meta.next_input (scalar): 暂无字段说明
- data.data.data.desc_v2[].type (integer|null): 暂无字段说明
- data.data.data.pages[].duration (integer|null): 暂无字段说明
- data.data.data.pages[].page (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes (array|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc (object|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.desc (string|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.duration (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.pubdate (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.stat (object|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.stat.danmaku (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.stat.reply (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.stat.view (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].arc.title (string|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].bvid (string|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].page (object|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].page.duration (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].page.page (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].pages (array|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].pages[].duration (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].pages[].page (integer|null): 暂无字段说明
- data.data.data.ugc_season.sections[].episodes[].title (string|null): 暂无字段说明
- data.data.data.ugc_season.sections[].title (string|null): 暂无字段说明
- data.data.data.ugc_season.sections[].type (integer|null): 暂无字段说明
- meta.next_input.video_id (string): 暂无字段说明

Follow up: GET /v1/native/results/{query_id}
读取已保存结果，不重复查询数据或收费。

