Markitdown Openrouter Integration

# MarkItDown 的 OpenRouter 集成 ## 概述 此 MarkItDown 智能体技能已配置为使用 **OpenRouter** 而非直接访问 OpenAI API。OpenRouter 提供了一个统一的 API 网关，通过单一的、兼容 OpenAI 的接口访问来自不同提供商的 100 多种 AI 模型。 ## 为什么选择 OpenRouter？ ### 优势 1. **多模型访问**：通过一个 API 即可访问 GPT-4、Claude、Gemini 及其他 100 多种模型 2. **无供应商锁定**：无需更改代码即可在不同模型间切换 3. **竞争性定价**：通常比直接购买更优惠 4. **简单迁移**：兼容 OpenAI 的 API 意味着极少的代码更改 5. **灵活选择**：为每项任务选择最佳模型 ### 图像描述的热门模型 | 模型 | 提供商 | 用途 | 视觉支持 | |-------|----------|----------|----------------| | `anthropic/claude-sonnet-4.5` | Anthropic | **推荐** - 科学分析的最佳选择 | ✅ | | `anthropic/claude-opus-4.5` | Anthropic | 出色的技术分析 | ✅ | | `openai/gpt-4o` | OpenAI | 强大的视觉理解能力 | ✅ | | `openai/gpt-4-vision` | OpenAI | 具备视觉能力的 GPT-4 | ✅ | | `google/gemini-pro-vision` | Google | 高性价比选项 | ✅ | 完整列表请见 https://openrouter.ai/models。 ## 入门指南 ### 1. 获取 API 密钥 1. 访问 https://openrouter.ai/keys 2. 注册或登录 3. 创建一个新的 API 密钥 4. 复制密钥（以 `sk-or-v1-...` 开头） ### 2. 设置环境变量 bash # 添加到您的环境 export OPENROUTER_API_KEY="sk-or-v1-..." # 使其永久生效 echo 'export OPENROUTER_API_KEY="sk-or-v1-..."' >> ~/.zshrc # macOS echo 'export OPENROUTER_API_KEY="sk-or-v1-..."' >> ~/.bashrc # Linux # 重新加载 shell source ~/.zshrc # 或 source ~/.bashrc ### 3. 在 Python 中使用 python from markitdown import MarkItDown from openai import OpenAI # 初始化 OpenRouter 客户端 (兼容 OpenAI) client = OpenAI( api_key="your-openrouter-api-key", # 或使用环境变量 base_url="https://openrouter.ai/api/v1" ) # 创建带有 AI 支持的 MarkItDown md = MarkItDown( llm_client=client, llm_model="anthropic/claude-sonnet-4.5" # 选择您的模型 ) # 使用 AI 增强描述进行转换 result = md.convert("presentation.pptx") print(result.text_content) ## 使用脚本 所有技能脚本均已更新为使用 OpenRouter： ### convert_with_ai.py bash # 设置 API 密钥 export OPENROUTER_API_KEY="sk-or-v1-..." # 使用默认模型进行转换 (高级视觉