nanhaoluo
1d8baeb84a
- 添加 stream 参数明确设置为非流式响应 - 添加 Accept 请求头确保返回 JSON 格式 - 使用 JSON_UNESCAPED_UNICODE 编码确保中文正确传输 - 添加详细的错误日志记录便于调试 - 改进 SSL 验证设置 - 增强 argon_get_xiaomi_models 函数的错误处理 - 添加测试脚本 test-xiaomi-mimo-api.php
251 lines
6.4 KiB
Markdown
251 lines
6.4 KiB
Markdown
# 小米 Mimo API 修复说明
|
||
|
||
## 修复时间
|
||
2026-01-26
|
||
|
||
## 问题描述
|
||
小米 Mimo 模型 API 请求失败，无法正常调用 MiMo-V2-Flash 模型。
|
||
|
||
## 修复内容
|
||
|
||
### 1. 优化 `argon_call_xiaomi_api` 函数
|
||
|
||
**修改位置**: `functions.php` 第 8047-8140 行
|
||
|
||
**主要改进**:
|
||
- ✅ 添加 `stream` 参数，明确设置为 `false`（非流式响应）
|
||
- ✅ 添加 `Accept` 请求头，明确接受 JSON 格式
|
||
- ✅ 使用 `JSON_UNESCAPED_UNICODE` 标志编码请求体，确保中文字符正确传输
|
||
- ✅ 明确设置 `sslverify` 为 `true`，确保 SSL 验证
|
||
|
||
**修改前**:
|
||
```php
|
||
$data = [
|
||
'model' => $model,
|
||
'messages' => [
|
||
['role' => 'system', 'content' => $prompt],
|
||
['role' => 'user', 'content' => $content]
|
||
],
|
||
'temperature' => 0.7,
|
||
'max_tokens' => 500
|
||
];
|
||
|
||
$response = wp_remote_post($endpoint, [
|
||
'headers' => [
|
||
'Content-Type' => 'application/json',
|
||
'Authorization' => 'Bearer ' . $api_key
|
||
],
|
||
'body' => json_encode($data),
|
||
'timeout' => 30
|
||
]);
|
||
```
|
||
|
||
**修改后**:
|
||
```php
|
||
$data = [
|
||
'model' => $model,
|
||
'messages' => [
|
||
['role' => 'system', 'content' => $prompt],
|
||
['role' => 'user', 'content' => $content]
|
||
],
|
||
'temperature' => 0.7,
|
||
'max_tokens' => 500,
|
||
'stream' => false
|
||
];
|
||
|
||
$response = wp_remote_post($endpoint, [
|
||
'headers' => [
|
||
'Content-Type' => 'application/json',
|
||
'Authorization' => 'Bearer ' . $api_key,
|
||
'Accept' => 'application/json'
|
||
],
|
||
'body' => json_encode($data, JSON_UNESCAPED_UNICODE),
|
||
'timeout' => 30,
|
||
'sslverify' => true
|
||
]);
|
||
```
|
||
|
||
### 2. 增强 `argon_get_xiaomi_models` 函数
|
||
|
||
**修改位置**: `functions.php` 第 9009-9055 行
|
||
|
||
**主要改进**:
|
||
- ✅ 添加 `Accept` 请求头
|
||
- ✅ 明确设置 `sslverify` 为 `true`
|
||
- ✅ 添加详细的错误日志记录
|
||
- ✅ 记录 HTTP 状态码和响应内容，便于调试
|
||
- ✅ 改进错误处理逻辑
|
||
|
||
**新增错误日志**:
|
||
- API 调用失败时记录错误信息
|
||
- HTTP 状态码非 200 时记录状态码和响应内容
|
||
- 响应格式异常时记录原始响应
|
||
|
||
## 可能的问题原因
|
||
|
||
根据修复内容，原始代码可能存在以下问题：
|
||
|
||
1. **缺少 stream 参数**: 某些 API 实现要求明确指定是否使用流式响应
|
||
2. **缺少 Accept 头**: API 可能需要明确的 Accept 头来返回正确格式
|
||
3. **中文编码问题**: 未使用 `JSON_UNESCAPED_UNICODE` 可能导致中文字符编码错误
|
||
4. **缺少错误日志**: 之前无法诊断具体的失败原因
|
||
|
||
## 测试方法
|
||
|
||
### 方法 1: 使用测试脚本
|
||
|
||
1. 打开 `test-xiaomi-mimo-api.php` 文件
|
||
2. 将 `YOUR_API_KEY_HERE` 替换为你的实际 API 密钥
|
||
3. 在浏览器中访问: `https://your-domain.com/wp-content/themes/argon/test-xiaomi-mimo-api.php`
|
||
4. 查看测试结果，包括：
|
||
- 基本 API 请求测试
|
||
- 简化请求格式测试
|
||
- 获取模型列表测试
|
||
- cURL 命令示例
|
||
|
||
### 方法 2: 在 WordPress 后台测试
|
||
|
||
1. 进入 WordPress 后台 → Argon 主题设置
|
||
2. 找到 "AI 功能" → "API 管理"
|
||
3. 添加或编辑小米 Mimo API 配置
|
||
4. 点击"测试"按钮
|
||
5. 查看测试结果
|
||
|
||
### 方法 3: 查看错误日志
|
||
|
||
如果仍然失败，检查 WordPress 错误日志：
|
||
|
||
```bash
|
||
# 查看 PHP 错误日志
|
||
tail -f /path/to/php-error.log
|
||
|
||
# 或者 WordPress debug.log
|
||
tail -f /path/to/wp-content/debug.log
|
||
```
|
||
|
||
错误日志会包含：
|
||
- API 调用失败的具体错误信息
|
||
- HTTP 状态码
|
||
- API 响应内容
|
||
|
||
## 小米 Mimo API 规范
|
||
|
||
### 端点
|
||
- **Chat Completions**: `https://api.mimo.xiaomi.com/v1/chat/completions`
|
||
- **Models**: `https://api.mimo.xiaomi.com/v1/models`
|
||
|
||
### 认证
|
||
使用 Bearer Token 认证：
|
||
```
|
||
Authorization: Bearer YOUR_API_KEY
|
||
```
|
||
|
||
### 请求格式
|
||
```json
|
||
{
|
||
"model": "MiMo-V2-Flash",
|
||
"messages": [
|
||
{"role": "system", "content": "你是一个有帮助的助手。"},
|
||
{"role": "user", "content": "你好"}
|
||
],
|
||
"temperature": 0.7,
|
||
"max_tokens": 500,
|
||
"stream": false
|
||
}
|
||
```
|
||
|
||
### 响应格式
|
||
```json
|
||
{
|
||
"id": "chatcmpl-xxx",
|
||
"object": "chat.completion",
|
||
"created": 1234567890,
|
||
"model": "MiMo-V2-Flash",
|
||
"choices": [
|
||
{
|
||
"index": 0,
|
||
"message": {
|
||
"role": "assistant",
|
||
"content": "你好！我是小米的 AI 助手..."
|
||
},
|
||
"finish_reason": "stop"
|
||
}
|
||
],
|
||
"usage": {
|
||
"prompt_tokens": 10,
|
||
"completion_tokens": 20,
|
||
"total_tokens": 30
|
||
}
|
||
}
|
||
```
|
||
|
||
## 支持的模型
|
||
|
||
根据官方文档，小米 Mimo 目前支持的模型：
|
||
|
||
- **MiMo-V2-Flash** (推荐)
|
||
- 309B 总参数，15B 活跃参数
|
||
- 256K 上下文窗口
|
||
- 擅长推理、编码和 Agent 场景
|
||
- 在 SWE-bench 上排名第一
|
||
|
||
## 常见问题
|
||
|
||
### Q1: API 密钥在哪里获取？
|
||
A: 访问 [小米 Mimo 平台](https://platform.xiaomimimo.com/) 注册并获取 API 密钥。
|
||
|
||
### Q2: API 是否免费？
|
||
A: 根据官方信息，MiMo-V2-Flash 目前处于公测阶段，可能提供免费额度。具体请查看官方文档。
|
||
|
||
### Q3: 为什么返回 401 错误？
|
||
A: 检查以下几点：
|
||
- API 密钥是否正确
|
||
- API 密钥是否已激活
|
||
- 是否正确设置了 Authorization 头
|
||
|
||
### Q4: 为什么返回 429 错误？
|
||
A: 请求频率超过限制，需要：
|
||
- 降低请求频率
|
||
- 检查是否有配额限制
|
||
- 联系小米客服增加配额
|
||
|
||
### Q5: 为什么返回 500 错误？
|
||
A: 服务器端错误，可能原因：
|
||
- API 服务暂时不可用
|
||
- 请求参数格式错误
|
||
- 模型名称错误
|
||
|
||
## 参考资料
|
||
|
||
- [LiteLLM - Xiaomi MiMo](https://docs.litellm.ai/docs/providers/xiaomi_mimo)
|
||
- [Puter.js - Free Xiaomi MiMo API](https://developer.puter.com/tutorials/free-unlimited-xiaomi-mimo-api/)
|
||
- [OpenRouter - MiMo-V2-Flash](https://openrouter.ai/xiaomi/mimo-v2-flash-20251210/api)
|
||
- [Hugging Face - MiMo-V2-Flash](https://huggingface.co/XiaomiMiMo/MiMo-V2-Flash)
|
||
|
||
## 后续优化建议
|
||
|
||
1. **添加重试机制**: 对于临时性失败，自动重试 2-3 次
|
||
2. **缓存模型列表**: 减少对 models 端点的请求
|
||
3. **支持流式响应**: 对于长文本生成，支持流式输出
|
||
4. **添加速率限制**: 避免触发 API 限流
|
||
5. **监控 API 使用**: 记录 API 调用次数和成本
|
||
|
||
## 相关文件
|
||
|
||
- `functions.php` - 核心函数（包含 API 调用逻辑）
|
||
- `test-xiaomi-mimo-api.php` - 测试脚本
|
||
- `settings.php` - 设置页面（AI 功能配置）
|
||
|
||
## Git 提交
|
||
|
||
提交信息将包含：
|
||
```
|
||
fix: 修复小米 Mimo API 请求失败的问题
|
||
|
||
- 添加 stream 参数明确设置为非流式响应
|
||
- 添加 Accept 请求头确保返回 JSON 格式
|
||
- 使用 JSON_UNESCAPED_UNICODE 编码确保中文正确传输
|
||
- 添加详细的错误日志记录便于调试
|
||
- 改进 SSL 验证设置
|
||
```
|