{
    "openapi": "3.1.0",
    "info": {
        "title": "潇楠 Web3哨兵 API",
        "version": "1.0.0",
        "description": "提供文本转语音、播客、图像/视频生成、市场分析、安全检测、快讯等 23 个 API 接口。",
        "contact": {
            "name": "潇楠 Web3哨兵 实验室",
            "email": "xiaonan@ming.store"
        },
        "license": {
            "name": "专有许可",
            "url": "https://www.ming.store/key/docs.php"
        }
    },
    "servers": [
        {
            "url": "https://www.ming.store",
            "description": "生产服务器"
        }
    ],
    "tags": [
        {
            "name": "文本转语音",
            "description": ""
        },
        {
            "name": "播客",
            "description": ""
        },
        {
            "name": "图像生成",
            "description": ""
        },
        {
            "name": "视频生成",
            "description": ""
        },
        {
            "name": "AI创作",
            "description": ""
        },
        {
            "name": "视频解析",
            "description": ""
        },
        {
            "name": "市场数据",
            "description": ""
        },
        {
            "name": "安全检测",
            "description": ""
        },
        {
            "name": "内容提取",
            "description": ""
        },
        {
            "name": "账户",
            "description": ""
        },
        {
            "name": "数字人",
            "description": ""
        },
        {
            "name": "资讯",
            "description": ""
        }
    ],
    "paths": {
        "/key/v1/tts.php": {
            "post": {
                "tags": [
                    "文本转语音"
                ],
                "summary": "文本转语音 (TTS)",
                "description": "将文本转换为 MP3 音频，返回可直接播放的音频链接（有效期 24 小时，请及时下载保存）。支持 20+ 种音色。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "API 密钥"
                    },
                    {
                        "name": "text",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "要合成语音的文本内容，最长 1024 字节。"
                    },
                    {
                        "name": "voice",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "BV007_streaming"
                        },
                        "description": "音色 ID，默认 BV007_streaming（亲切女声）。可选值见接口文档。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "audio_url": "https://www.ming.store/uploads/tts/tts_xxxxx.mp3",
                                    "expires_at": "2026-07-22 12:00:00",
                                    "note": "音频链接有效期为 24 小时，请及时下载保存。"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/podcast.php": {
            "post": {
                "tags": [
                    "播客"
                ],
                "summary": "双人语音播客（提交任务）",
                "description": "提交文本或网页链接，AI 自动生成双人对话播客音频。返回任务 ID，需轮询查询结果。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "action",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "生成模式：0=文本总结，3=对话文本，4=联网总结。"
                    },
                    {
                        "name": "text",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "输入文本（action=0/3 时使用）。"
                    },
                    {
                        "name": "input_url",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "网页链接（action=0 时使用）。"
                    },
                    {
                        "name": "prompt_text",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "搜索关键词（action=4 时使用）。"
                    },
                    {
                        "name": "speaker1",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "zh_male_dayixiansheng_v2_saturn_bigtts"
                        },
                        "description": "发音人1，默认大仙先生。可选值见文档。"
                    },
                    {
                        "name": "speaker2",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "zh_female_mizaitongxue_v2_saturn_bigtts"
                        },
                        "description": "发音人2，默认咪仔同学。"
                    },
                    {
                        "name": "audio_format",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "mp3"
                        },
                        "description": "音频格式，默认 mp3。"
                    },
                    {
                        "name": "use_head_music",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "片头音效：1=开启，0=关闭。"
                    },
                    {
                        "name": "use_tail_music",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "片尾音效：1=开启，0=关闭。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "task_id": "a1b2c3d4e5f6..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/podcast_check.php": {
            "get": {
                "tags": [
                    "播客"
                ],
                "summary": "双人语音播客（查询任务）",
                "description": "根据 task_id 查询播客任务状态和音频链接。查询接口不消耗调用次数。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "task_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "播客任务返回的 task_id。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "status": "done",
                                    "audio_url": "https://cdn.ming.store/podcast/xxx.mp3"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/image.php": {
            "post": {
                "tags": [
                    "图像生成"
                ],
                "summary": "文生图",
                "description": "根据提示词生成图片，返回图片 URL。支持图生图。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "prompt",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "图片描述提示词。"
                    },
                    {
                        "name": "size",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "1024x768"
                        },
                        "description": "尺寸：1024x768、1024x1024、768x1024。"
                    },
                    {
                        "name": "image_url",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "参考图 URL（图生图）。"
                    },
                    {
                        "name": "negative_prompt",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "反向提示词。"
                    },
                    {
                        "name": "seed",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "随机种子。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "url": "https://cdn.example.com/images/xxx.png"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/video.php": {
            "post": {
                "tags": [
                    "视频生成"
                ],
                "summary": "文生视频（提交任务）",
                "description": "根据提示词生成视频，返回 video_id，需轮询查询进度。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "prompt",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "width",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1152
                        },
                        "description": ""
                    },
                    {
                        "name": "height",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 768
                        },
                        "description": ""
                    },
                    {
                        "name": "num_frames",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "帧数（81-441），默认 121（约 5 秒）。"
                    },
                    {
                        "name": "frame_rate",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 24
                        },
                        "description": ""
                    },
                    {
                        "name": "image_url",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "参考图 URL（图生视频）。"
                    },
                    {
                        "name": "negative_prompt",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "seed",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "video_id": "xxx",
                                    "task_id": "xxx",
                                    "status": "queued"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/video_check.php": {
            "get": {
                "tags": [
                    "视频生成"
                ],
                "summary": "文生视频（查询任务）",
                "description": "根据 video_id 查询进度和视频链接。查询不消耗调用次数。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "video_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "视频任务返回的 video_id。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "status": "completed",
                                    "url": "https://cdn.example.com/videos/xxx.mp4",
                                    "progress": 100
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/article.php": {
            "post": {
                "tags": [
                    "AI创作"
                ],
                "summary": "AI 一键创作",
                "description": "根据关键词生成原创文章，返回标题、正文（HTML 格式）、摘要和标签。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "keywords",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "文章主题或关键词。"
                    },
                    {
                        "name": "model_index",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 0
                        },
                        "description": ""
                    },
                    {
                        "name": "style",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "professional"
                        },
                        "description": "写作风格：professional, easy, tutorial, news, product。"
                    },
                    {
                        "name": "length",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "standard"
                        },
                        "description": "文章长度：mini, short, medium, standard。"
                    },
                    {
                        "name": "web_search_serpapi",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": ""
                    },
                    {
                        "name": "web_search_serper",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "title": "文章标题",
                                    "content": "<p>文章正文...</p>",
                                    "excerpt": "摘要",
                                    "tags": "标签1,标签2"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/video_parse.php": {
            "post": {
                "tags": [
                    "视频解析"
                ],
                "summary": "视频解析",
                "description": "解析抖音或 TikTok 视频链接，返回无水印视频直链。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "抖音或 TikTok 视频链接。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "platform": "douyin",
                                    "title": "视频标题",
                                    "duration": 30.5,
                                    "thumbnail": "https://...",
                                    "direct_url": "https://...",
                                    "uploader": "作者名"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/market_analyze.php": {
            "post": {
                "tags": [
                    "市场数据"
                ],
                "summary": "市场数据 + AI 分析",
                "description": "获取指定交易对的实时市场数据，并由 AI 智能体生成分析报告。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "pair",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "交易对，如 BTCUSDT。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "raw_data": [
                                        "..."
                                    ],
                                    "ai_analysis": "..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/risk_analyze.php": {
            "post": {
                "tags": [
                    "市场数据"
                ],
                "summary": "开仓风控检查 + AI 解读",
                "description": "输入交易计划，结合实时数据生成风控评分和建议。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "pair",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "side",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "方向：long 或 short。"
                    },
                    {
                        "name": "leverage",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "number",
                            "default": 10
                        },
                        "description": ""
                    },
                    {
                        "name": "position_size",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "stop_loss",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "holding_time",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "reason",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "risk_report": {
                                        "score": 3,
                                        "level": "高"
                                    },
                                    "ai_analysis": "..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/token_analyze.php": {
            "post": {
                "tags": [
                    "安全检测"
                ],
                "summary": "代币安全检测 + AI 分析",
                "description": "检测代币合约安全性（蜜罐、税率、增发权限等），并提供 AI 风险解读。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "address",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "代币合约地址。"
                    },
                    {
                        "name": "chain_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "56"
                        },
                        "description": "链 ID，默认 BSC（56）。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "raw_data": {
                                        "tag_name": "⚠️ 中风险代币"
                                    },
                                    "ai_analysis": "..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/token_audit_analyze.php": {
            "post": {
                "tags": [
                    "安全检测"
                ],
                "summary": "代币合约审计 + AI 解读",
                "description": "全面的链上安全审计，检测蜜罐、税率、开源状态等。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "contract_address",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "chain_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "56"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "raw_data": [
                                        "..."
                                    ],
                                    "ai_analysis": "..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/dexscreener_analyze.php": {
            "post": {
                "tags": [
                    "市场数据"
                ],
                "summary": "DEX 交易对分析 + AI 解读",
                "description": "获取代币在所有 DEX 上的交易对、流动性等数据，并提供 AI 分析。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "token_address",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "chain",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "链标识：ethereum, bsc, solana, base, arbitrum, polygon。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "raw_data": [
                                        "..."
                                    ],
                                    "ai_analysis": "..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/extract.php": {
            "post": {
                "tags": [
                    "内容提取"
                ],
                "summary": "网页内容提取 + AI 分析",
                "description": "支持三种模式：basic（纯提取）、summary（生成摘要）、social（社交媒体分析）。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "网页链接，最多 3 个用逗号分隔。"
                    },
                    {
                        "name": "mode",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "basic"
                        },
                        "description": "模式：basic, summary, social。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "mode": "basic",
                                    "results": [
                                        {
                                            "url": "https://...",
                                            "raw_content": "..."
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/quota.php": {
            "post": {
                "tags": [
                    "账户"
                ],
                "summary": "KEY 配额查询",
                "description": "查询当前 API Key 的总次数、已使用次数和剩余可用次数。本接口不消耗调用次数。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "total_quota": 500,
                                    "used_quota": 15,
                                    "remaining": 485
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/digital_human.php": {
            "post": {
                "tags": [
                    "数字人"
                ],
                "summary": "AI数字人视频生成 (OmniHuman)（提交任务）",
                "description": "提交文本、图片URL和音色，生成数字人播报视频。消耗 50 次配额。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "text",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "播报文本，最长300字。"
                    },
                    {
                        "name": "image_url",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "人物图片URL。"
                    },
                    {
                        "name": "voice",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "BV007_streaming"
                        },
                        "description": "音色ID。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "task_id": "a1b2c3d4e5f6...",
                                    "note": "视频生成需要 2-5 分钟，请使用 digital_human_check 接口轮询结果"
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/digital_human_check.php": {
            "get": {
                "tags": [
                    "数字人"
                ],
                "summary": "AI数字人视频生成 (OmniHuman)（查询任务）",
                "description": "查询生成进度和视频链接。不消耗调用次数。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "task_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "status": "done",
                                    "video_url": "https://..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/digital_human_volcv2.php": {
            "post": {
                "tags": [
                    "数字人"
                ],
                "summary": "AI数字人 (单图音频驱动 V2)（提交任务）",
                "description": "提交文本、图片URL和音色，先创建数字形象再生成口型同步视频。消耗 20 次配额。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "text",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "image_url",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "voice",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "BV007_streaming"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "task_id": "a1b2c3d4e5f6..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/digital_human_volcv2_check.php": {
            "get": {
                "tags": [
                    "数字人"
                ],
                "summary": "AI数字人 (单图音频驱动 V2)（查询任务）",
                "description": "查询进度和视频链接。不消耗调用次数。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "task_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "status": "done",
                                    "video_url": "https://..."
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/newsflash.php": {
            "get": {
                "tags": [
                    "资讯"
                ],
                "summary": "实时 Web3 快讯",
                "description": "获取 Odaily 星球日报实时快讯，支持按分类筛选、关键词搜索和分页。每次调用消耗 1 次配额。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "category",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "all"
                        },
                        "description": "快讯分类，默认 all。可选值：ai, funding, on-chain-data 等。"
                    },
                    {
                        "name": "keyword",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "搜索关键词，优先于 category。"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "description": ""
                    },
                    {
                        "name": "size",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 10
                        },
                        "description": "每页条数，最大 50。"
                    },
                    {
                        "name": "lang",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "zh-cn"
                        },
                        "description": "语言，默认 zh-cn。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "data": {
                                        "list": [],
                                        "total": 0
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        },
        "/key/v1/trump_feed.php": {
            "post": {
                "tags": [
                    "资讯"
                ],
                "summary": "特朗普动态追踪",
                "description": "获取特朗普在 Truth Social 和 Twitter/X 双平台的最新帖子和推文。每次调用消耗 3 次配额。",
                "parameters": [
                    {
                        "name": "api_key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": ""
                    },
                    {
                        "name": "action",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "get"
                        },
                        "description": "操作类型：get=获取缓存，refresh=强制刷新。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": []
                                },
                                "example": {
                                    "success": true,
                                    "posts": []
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "401": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    },
                    "500": {
                        "$ref": "#/components/schemas/ErrorResponse"
                    }
                },
                "security": [
                    {
                        "ApiKeyQuery": []
                    }
                ]
            }
        }
    },
    "components": {
        "securitySchemes": {
            "ApiKeyQuery": {
                "type": "apiKey",
                "in": "query",
                "name": "api_key",
                "description": "API 密钥"
            }
        },
        "schemas": {
            "ErrorResponse": {
                "type": "object",
                "properties": {
                    "success": {
                        "type": "boolean",
                        "example": false
                    },
                    "error": {
                        "type": "string",
                        "example": "错误描述"
                    }
                }
            }
        }
    },
    "security": [
        {
            "ApiKeyQuery": []
        }
    ]
}