From b00b9551385638e6cc9ea6616e6e49cde596c353 Mon Sep 17 00:00:00 2001
From: yyyytawa <116234899+yyyytawa@users.noreply.github.com>
Date: Thu, 11 Jun 2026 16:22:34 +0800
Subject: [PATCH] docs: /v1/live/stream-info

---
 src/api/v1/live.md | 47 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/src/api/v1/live.md b/src/api/v1/live.md
index 6114ebcb..cf35d44c 100644
--- a/src/api/v1/live.md
+++ b/src/api/v1/live.md
@@ -209,3 +209,50 @@ POST /v1/live/get-calling
 ```
 
 :::
+
+## 获取推流信息
+
+POST /v1/live/stream-info
+
+请求头:
+
+| 名称  | 必须 |   备注   |
+| ----- | ---- | ------- |
+| token | 是   | VIP 用户 |
+
+请求体：
+
+```JSON
+{ "roomId":"11451419180123456abcdefe0fed533" } // 要获取推流码的房间 ID
+```
+
+响应体:
+
+::: tabs
+
+@tab:active 正常响应
+
+```JSON
+{
+  "code": 1,
+  "data": {
+    "streamKey": "abcdef", // 推流码
+    "url": "https://live-push.jwzhd.com/whip" // 推流地址
+  },
+  "msg": "success"
+}
+```
+
+@tab 不带 token/无效 token
+
+```JSON
+{ "code":-101, "msg":"未登录" }
+```
+
+@tab 非 VIP 用户的 token
+
+```JSON
+{ "code":-1, "msg":"功能仅限VIP用户使用" }
+```
+
+:::
\ No newline at end of file