index.html

<!DOCTYPE html>
<html>
<head>
    <title>API 接口说明</title>
    <link rel="icon" type="image/png" href="/static/favicon.png">
    <style>
        body { font-family: Arial, sans-serif; margin: 20px; }
        h1 { color: #333; }
        .endpoint { margin: 20px 0; padding: 15px; background: #f5f5f5; border-radius: 5px; }
        .method { font-weight: bold; color: #007bff; }
        .url { color: #28a745; }
        .description { margin-top: 10px; }
    </style>
</head>
<body>
    <h1>API 接口说明</h1>
    
    <h2>项目概述</h2>
    <p>这是一个基于 FastAPI 实现的通义千问 API 代理服务器，用于转发和处理与通义千问 API 的通信。</p>

    <h2>主要功能</h2>
    <ul>
        <li>模型列表获取 API</li>
        <li>聊天完成 API</li>
        <li>支持流式响应</li>
        <li>内置模型列表缓存机制</li>
        <li>自动重试机制</li>
    </ul>

    <h2>环境要求</h2>
    <ul>
        <li>Python 3.7+</li>
        <li>FastAPI 0.104.1+</li>
        <li>Uvicorn 0.24.0+</li>
        <li>HTTPX 0.25.1+</li>
    </ul>

    <h2>安装步骤</h2>
    <ol>
        <li>克隆项目到本地</li>
        <li>安装依赖：
            <pre><code>pip install -r requirements.txt</code></pre>
        </li>
        <li>使用 Docker（可选）：
            <pre><code>docker build -t qwen-api-proxy .
docker run -p 8000:8000 qwen-api-proxy</code></pre>
        </li>
    </ol>

    <h2>运行服务</h2>
    <pre><code>python qwen.py</code></pre>
    <p>或使用 uvicorn：</p>
    <pre><code>uvicorn qwen:app --host 0.0.0.0 --port 8000</code></pre>
    <p>服务将在 <a href="http://localhost:8000">http://localhost:8000</a> 上运行。</p>

    <h2>错误处理</h2>
    <ul>
        <li>服务内置了自动重试机制，最多重试3次</li>
        <li>500错误或HTML响应会触发重试</li>
        <li>401错误表示未授权，需要检查token</li>
        <li>400错误表示请求参数有误</li>
    </ul>

    <h2>获取 API Key</h2>
    <ol>
        <li>访问 <a href="https://chat.qwenlm.ai/">https://chat.qwenlm.ai/</a> 并登录</li>
        <li>打开浏览器开发者工具（通常按 F12）</li>
        <li>切换到"应用程序"选项卡</li>
        <li>在左侧菜单中选择"Cookies" -> "https://chat.qwenlm.ai"</li>
        <li>找到名称为"token"的cookie</li>
        <li>复制其值，这就是你的API Key</li>
    </ol>

    <h2>许可证</h2>
    <p>本项目采用 MIT License 开源许可证。</p>
    
    <div class="endpoint">
        <div class="method">GET</div>
        <div class="url">/api/models</div>
        <div class="description">
            获取可用模型列表<br>
            请求头需要包含 Authorization: Bearer {api_key}
        </div>
    </div>

    <div class="endpoint">
        <div class="method">POST</div>
        <div class="url">/api/chat/completions</div>
        <div class="description">
            与模型进行对话<br>
            请求头需要包含 Authorization: Bearer {api_key}<br>
            支持流式响应（stream: true）
        </div>
    </div>
</body>
</html>