需先获取并验证skywork api密钥，再按要求配置图文推理、双模型路由及深度研究调用；密钥需通过curl测试，r1v4-lite输入必须含text项，双模型需设routing_rules，deep research须指定max_depth。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在自己的程序里调用Skywork AI的API来实现图文理解、多轮对话或深度研究能力，但卡在密钥配置、请求格式或模型选型上，导致返回401错误或空响应。
获取并验证Skywork API密钥
访问 https://skywork.ai → 点击右上角“Sign In”登录账户 → 进入个人设置页 → 找到“API Keys”板块 → 点击“Create New Key”，填写描述（如“dev-local-test”）→ 复制生成的密钥字符串，务必保存到安全位置。
【密钥有效期默认为90天，过期后API将立即拒绝所有请求】
打开终端执行测试命令验证密钥有效性：curl -X GET "https://api.skyworkmodel.ai/v1/models" -H "Authorization: Bearer sk-xxx..." -H "Content-Type: application/json"。若返回包含skywork/r1v4-lite等模型名的JSON列表，说明密钥已激活；若返回{"error": "invalid_api_key"}，请检查是否复制了空格或换行符。
Python环境接入R1V4-Lite图文推理API
方法一：使用requests原生调用（轻量可控）
安装依赖：pip install requests pillow
准备图像并转base64：
用PIL打开图片→统一转为RGB模式→保存为JPEG字节流→base64编码。这一步不可跳过，否则R1V模型可能因通道数异常（如RGBA）而静默失败。
构造请求体时，【content字段必须是list类型，且至少包含一个{"type":"text","text":"..."}项，纯图像输入不被接受】。示例结构如下：
[{"type":"image_url","image_url":{"url":"data:image/jpeg;base64,/9j/4AAQ..."}},{"type":"text","text":"请逐项分析图中所有数学公式并指出是否有计算错误"}]
配置双模型路由策略（Claude+Gemini协同）
第一步：在Skywork桌面版目录下运行初始化脚本python scripts/init_config.py 生成默认config.json，该文件定义了主副模型调度规则。
第二步：写入双模型密钥
执行python scripts/set_api_key.py --model claude --key "sk-ant-..."配置Anthropic密钥；再执行python scripts/set_api_key.py --model gemini --key "AIzaSy..."写入Google Gemini密钥。
第三步：启用智能路由引擎
编辑config.json中的"routing_rules"节点，添加条件：{"task_type":"math_reasoning","min_length":50,"fallback_to":"gemini"}。当用户提问含“证明”“推导”“求解”且字符数超50时，自动交由Gemini 3 Pro处理；其余常规问答由Claude 3.5 Sonnet响应。
这一步完成后，调用http://localhost:8088/v1/chat/completions即可触发双模型动态分发，无需修改业务代码。
调用Deep Research专家智能体
直接向https://api.skyworkmodel.ai/v1/deepresearch发送POST请求，header中携带Authorization: Bearer sk-...和Content-Type: application/json。
请求体必须包含"query"（用户原始问题）、"sources"（可选知识库ID列表）和"max_depth"（搜索递归深度，建议设为2～3）。例如研究“2026年国产14B级开源大模型技术路线对比”，需明确指定"max_depth":2，否则默认单层检索会遗漏关键论文与评测数据。
响应返回"final_answer"和"citations"两个字段，其中每个citation包含source_url与excerpt，可直接用于生成带来源标注的报告。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
