# 懒人AI完整文档

更新时间：2026-11-04。模型权限与现价以当前账户为准。

# 把接入交给AI

如果你已经有能操作本机或目标项目的AI，可以让它按本文完成最小配置。不要把API密钥直接写进提示词；告诉AI密钥存在哪个已授权的秘密存储中，或者在客户端确认框里自己填写。

## 复制给AI

```text
请按懒人AI文档帮我接入我指定的客户端/项目。

目标客户端或项目：由我指定；不明确时一次问清。
需要的分组和模型：以我的密钥权限、当前模型广场为准。
新接入且我未指定分组时：Claude推荐自制号池，GPT推荐「GPT 神秘渠道」，先读分组说明并确认本站当前可选；已有正常配置保留，不自动迁移或扩大密钥权限。
文档：DSH直接读取DSH自定义提供商教程；其他编程客户端读取Magpie教程。程序、图片和视频使用对应API教程，不凭记忆猜接口。
API主地址：https://otz.si；本站支持常用无前缀兼容。原配置正常时不要强制追加/v1，特定客户端字段按对应教程填写。
密钥：只从我授权的秘密存储取用，或让我在本机界面填写，不在聊天、日志或Git中展示。

执行边界：
1. 先检查是否已有同用途配置；只修改地址、协议、模型、密钥等必要字段。
2. 已有可用配置优先保留；DSH在设置→模型中添加自定义模型API，无需额外安装Magpie；其他编程客户端按Magpie教程中对应模型类别的无密钥入口添加。让用户填写自己所选分组的密钥，获取该密钥可用模型，不逐个手填。不改后端、不重装工具、不跑整套测试。
3. 保留当前登录、MCP、插件、权限和其他供应商。当前任务未结束，不切换供应商、不重启客户端、不启用本地路由。
4. Magpie先只添加供应商，不分配给正在运行的应用；当前任务结束后再切换。若提示替换已有供应商，先取消，不覆盖原配置。
5. 原生协议优先：Codex用Responses，Claude Code用Messages；Kiro积分不擅自桥接为Chat。
6. 默认零收费，只检查配置和必要的一次模型发现。收费请求必须取得我本轮明确次数和预算；不测全模型、不自动重试结果不明的生成。
7. 图片用Images；视频用Videos异步提交/查询/下载。没有任务ID或超时，先查状态，不重复提交。
8. 不更改价格、分组、客户密钥权限，不自动换模型或设置跨组故障转移。
9. 只报告变更字段、回退方法及实际验证范围。配置成功不能写成生成成功；达到目标就停止。
```

## 机器阅读入口

- [文档索引 llms.txt](/docs/llms.txt)：先定位需要的教程，不必每次读取整站。
- <a href="/docs/markdown/ai.md" download>本页Markdown</a>：可直接交给AI。
- [完整文本 llms-full.txt](/docs/llms-full.txt)：需要离线阅读时使用。
- 每页均有对应的`/docs/markdown/页面名.md`，例如`/docs/markdown/images.md`。

这些文件与网页来自同一份原稿。`llms.txt`是阅读入口，不是让AI自动获得执行权限，也不保证所有AI产品会主动抓取它。

## 给中转站维护AI的额外说明

一枚密钥不能默认访问所有分组。按目标系统已有功能选择对应协议和渠道；只接用户指定范围。不复制整个站点设置，不假设本站售价等于接入方售价。

遇到credit、视频异步任务等特殊计费，先检查目标系统是否支持。不能支持时只暂停该能力，解释缺项；不要为了普通接入自行修改核心计费代码、安装未知插件或发起生产部署。

---

# API与文本调用

主地址为 `https://otz.si`。下面给出完整标准路径，客户端Base URL是否带`/v1`以该客户端教程为准。本站常用无`/v1`路径兼容保留，但不要拼出`/v1/v1/...`。

## 接口速查

| 能力 | 方法与路径 |
| --- | --- |
| 当前密钥可见模型 | `GET /v1/models` |
| Chat Completions | `POST /v1/chat/completions` |
| Responses | `POST /v1/responses` |
| Anthropic Messages | `POST /v1/messages` |
| 图片生成 | `POST /v1/images/generations` |
| 提交视频 | `POST /v1/videos` |
| 查询视频 | `GET /v1/videos/{id}` |
| 下载视频 | `GET /v1/videos/{id}/content` |

不同模型可用的端点不同；这张表不是每个模型支持全部端点的承诺。

## 鉴权

JSON请求通常使用以下请求头，密钥替换为自己的调用密钥：

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

Anthropic客户端也可按原生配置使用`x-api-key`和`anthropic-version: 2023-06-01`。密钥只保存在秘密字段或受限配置里，不放URL，不使用`curl -v`、完整请求头日志或公开前端代码传递密钥。

## 免计费模型发现

下载 [本地请求示例 request.py](/docs/examples/request.py)，在电脑终端运行：

```sh
python3 request.py /v1/models
```

Windows可使用`py -3`替代`python3`。程序会隐藏输入密钥；只访问`https://otz.si`，不写任何客户端配置、不自动重试。

返回JSON的`data[].id`为模型ID。目录成功只是免计费配置检查，不是模型生成成功。

## 发起一次文本请求

把下面任意一种JSON保存为`request.json`，将模型名换为这枚密钥实际支持的完整名称。`YOUR_MODEL_ID`是占位符，不能原样发送。

### Responses

```json
{
  "model": "gpt-6.1-sol",
  "input": [{"role": "user", "content": [{"type": "input_text", "text": "只回复：连接成功"}]}],
  "stream": false,
  "max_output_tokens": 64
}
```

```sh
python3 request.py /v1/responses --json request.json --allow-charge
```

### Chat Completions

```json
{
  "model": "YOUR_MODEL_ID",
  "messages": [{"role": "user", "content": "只回复：连接成功"}],
  "stream": false,
  "max_tokens": 64
}
```

```sh
python3 request.py /v1/chat/completions --json request.json --allow-charge
```

### Anthropic Messages

```json
{
  "model": "YOUR_MODEL_ID",
  "max_tokens": 64,
  "messages": [{"role": "user", "content": "只回复：连接成功"}],
  "stream": false
}
```

```sh
python3 request.py /v1/messages --json request.json --allow-charge
```

`--allow-charge`表示你主动同意这一次生成，程序仍会要求确认。它不是价格预算器；设置Token上限不代表有总金额硬上限。请求失败、超时或输出不完整时，不自动重发。

## 接入实际程序

先选择协议和完整模型名，再按SDK字段配置地址。把密钥留在服务端秘密存储或用户本机，不写死到浏览器脚本。不要为接入改全局系统代理、清空客户端配置、重装编程工具或关闭TLS验证。

流式请求设置`stream: true`，使用支持SSE的客户端。上面的简易Python示例仅用于非流式JSON及单次视频查询，不用于读取长流。收到HTTP 200或首个事件不等于生成结束，按对应协议的完成事件判断。

保留响应头`X-Oneapi-Request-Id`及开始时间用于排障；不要记录密钥和完整提示词。取消任务应传播取消请求，不在后台继续无止境重试。429/503先尊重`Retry-After`，对结果不明的生成请求先查状态再决定是否重试。

---

# 价格与用量

价格说明核对于 **2026-11-03，Asia/Shanghai**。本文列固定规则和读账方法；变化频繁的文本价格请在 [模型广场](https://otz.si/pricing) 选择自己的分组查看，最终核对使用记录。

## 文本模型

常见单位为人民币/百万Token，输入、输出、缓存读取、缓存写入分别计价。长上下文、缓存写入时长和部分模型峰谷时段可能改变单价。

2026-11-03 文本模型费用已调整，最新价格见[模型广场](https://otz.si/pricing)。已有密钥和客户端配置无需修改。

- 已按所选分组显示的最终单价，不要再乘一次倍率。
- “输入Token”是否包含缓存，取决于协议和日志字段；不能把总输入、缓存读写全部相加重复计算。
- 本地客户端展示的费用可能采用厂商默认价、美元价或旧配置，不等于本站实际扣费。
- 分组名称不构成稳定性、上下文长度或“不降智”的保证，以明确能力说明和实际返回为准。

## 请求取消与输入估算

Claude 文本模型使用 Anthropic Messages 接口时，请求完整发出后，客户端在收到响应前取消且没有实际用量的，按本地估算的输入 Token 结算，输出与缓存读写不估算。账单会注明“输入 Token 估算”；估算可能与模型实际统计不同，不能据此认定生成成功。已拿到有效用量的仍按用量结算。

未发出的请求不收这笔费用，取消后不自动重试，也不追补历史请求。积分组、图片、视频和独立不限量渠道不适用这条输入估算规则。遇到金额疑问请提供请求 ID 给客服，不要重复提交来验证。

## GPT图片

标准「GPT 图片」组下，以下四款模型统一 **¥0.05/张**，按实际生成张数计费，不按1K/2K/4K分别加价。

| 完整模型名 | 单张价格 |
| --- | --- |
| `gpt-image-2` | ¥0.05 |
| `gpt-image-2.5` | ¥0.05 |
| `gpt-image-2.5-flare` | ¥0.05 |
| `gpt-image-2.5-sunburst` | ¥0.05 |

例如实际生成2张为¥0.10。尺寸是生成参数，实际像素以返回图片为准；请求4K不等于保证原生4K细节。参见[图片教程](/docs/markdown/images.md)。

## Kiro积分

「Claude Kiro 积分」按 **¥0.15/credit** 计费，客户倍率1；不按该次Token量另加一笔普通文本费。支持的`web_search`工具按现行 **¥0.01/次** 单独计费。

计算示例（非真实用户账单）：0.02 credit、不使用搜索时，积分费为¥0.003；同样积分再使用一次计费搜索，合计¥0.013。最终记录可能受记账精度取整影响。

合法credit=0且没有工具费时免费。**不能把所有报错、拒答、断流一概当作免费**：是否产生有效积分或工具调用，以该请求账单为准。遇到缺少/无效积分字段，本站不会擅自改用Token估算补扣。详见[Kiro说明](/docs/markdown/kiro.md)。

## 视频

视频价格随模型、分辨率和时长变化，提交前选择对应视频分组查看报价。Seedance使用视频Token维度结算，MiniMax H3使用秒数维度；不能套用图片单张价或文本Token价。

2026-11-03 已下调现有视频基础单价，视频分组倍率和计费单位不变。GPT 图片仍为 ¥0.05/张，Kiro 积分仍为 ¥0.15/credit，不适用文本倍率调整。

任务可能经历预扣和最终结算。客户端超时不等于服务端任务失败，也不代表已经退款。先查同一个任务与账单，结果不明时不要重复提交。

## 安全使用额度

首次配置使用有额度与有效期限制的独立密钥。预算需要同时考虑生成、工具费及已提交的异步任务；“最大输出Token”不是总费用硬上限。对金额有疑问时提交请求ID给客服，不要通过反复调用来验证价格。

## 支付宝充值

2026-10-31 更新：在 [钱包](https://otz.si/wallet) 选择充值金额 → 支付宝 → 扫码，**按收银台显示的精确金额付款一次**。收银台域名为 `alipay.otz.si`；微信和 USDT 入口保持不变。

为区分订单，实付金额可能带分位尾数。例如充值 ¥1 的订单可能要求支付 ¥1.01，站内增加的仍是所选 ¥1；请先确认两项金额，不要自行抹掉尾数。

请在页面倒计时内付款。**已付款但页面显示过期时，不要重复付、不要重新下单**：先查看钱包「订单历史」。确认结果短暂未更新可刷新；仍未到账，请向 [客服](/docs/markdown/support.md) 提供订单号、金额和支付时间。尚未付款且页面已过期，才重新下单；不要向保存的旧二维码直接付款。

---

# DSH 接入懒人AI

DSH（DeepSeek Harness）可以直接添加懒人AI，不需要先装 Magpie。还没安装？从 [DeepSeek 官网](https://www.deepseek.com/harness/) 下载桌面端。

## 1 打开添加页面

打开 DSH → **设置 → 模型 → 添加模型提供商**，切换到 **自定义模型 API**。

不要把本站密钥填进内置的 DeepSeek 官方卡片。

## 2 填地址和自己的密钥

使用 Claude 推荐自制号池，GPT / Codex 推荐「GPT 神秘渠道」。先按[分组说明](/docs/markdown/groups.md)创建对应密钥，再在 DSH 添加提供商；不同分组不要共用同一枚密钥。

以 DeepSeek 等国产文本模型为例：

| 填写项 | 填什么 |
| --- | --- |
| Provider ID | `lanren-ai`（已有同名项就换一个，不覆盖） |
| 显示名称 | `懒人AI` |
| API 地址 | `https://otz.si` |
| API 协议 | **OpenAI Chat Completions** |
| API 密钥 | 从本站 [API 密钥](https://otz.si/keys) 复制对应分组的密钥，不是登录密码 |

点 **获取可用模型** → 勾选要使用的模型 → 添加到列表 → **创建提供商**。不用逐个抄模型名；获取失败时，再到 [模型广场](https://otz.si/pricing) 复制该分组支持的完整名称手动添加。

::: details 用 GPT 或 Claude？改这两项

| 模型路线 | API 协议 | API 地址 |
| --- | --- | --- |
| GPT / Codex 模型 | OpenAI Responses | `https://otz.si` |
| Claude 模型 | Anthropic Messages | `https://otz.si` |

使用对应分组密钥；不同协议分别建提供商，ID 不重复。Kiro 积分必须保留 Messages，不转换成 Chat；它在 DSH 中尚未实测。

本站已兼容无前缀调用，以上地址统一填主域名，不用手动加 `/v1`。已有带 `/v1` 且正常的配置也不用改。
:::

::: details 看一下官方表单长什么样

![DSH 官方自定义模型 API 表单，示例域名请换成上表的本站地址](/docs/assets/dsh-provider-official.png)

图片来自 [DeepSeek 官方模型配置教程](https://deepseek-harness.github.io/deepseek-harness/guide/providers)，不是本站实测截图。
:::

## 3 选模型，开始使用

回到聊天页，新建会话，在模型选择器里选 **懒人AI → 对应模型**。若输入框不可用，先添加并选中工作区。

接好就可以使用，不必测试全部模型。详细功能可问接入后的 AI，或看 [官方教程](https://deepseek-harness.github.io/deepseek-harness/guide/providers)。

<small>2026-10-28 已核对官方流程；本轮未在 DSH 发起生成。这里只配置文本模型；图片/视频生成请看本站对应教程。</small>

---

# 常见问题

## Base URL到底要不要加v1

**本站客户端教程统一填`https://otz.si`，不用手动加`/v1`。** 本站已兼容无前缀调用；已有带`/v1`且正常的配置也不用改。

| 配置位置 | 填写 |
| --- | --- |
| Magpie的Chat / Responses / Anthropic字段 | `https://otz.si` |
| DSH自定义模型API地址 | `https://otz.si`，协议按模型路线选择 |
| 直接发HTTP请求 | 使用API页列出的完整路径 |

2026-10-28已核查：`/responses`、`/chat/completions`、`/models`与对应`/v1/...`路径都可到达鉴权接口；服务器配置也保留了对应转发。这是免计费路由检查，不等于所有客户端都已生成实测；Magpie图片单次验证的实际范围见[核验记录](/docs/markdown/verification.md)。

不要重复拼出`/v1/v1`。旧域名仅保留历史兼容，新配置用`otz.si`；`otz.ai`不是本站地址。

## 401或invalid key

检查是否把登录密码当成密钥、复制时有空格、密钥已停用/到期。确认地址是本站。不要把密钥发给客服；需要更换时先配置并确认新密钥，再停用旧密钥。

## 403或model not found

检查所选组、密钥模型限制及完整模型名。账户模型列表不一定等于这枚密钥的权限；用这枚密钥读一次模型发现即可，不进行批量生成试错。不要自行换代或删除日期后缀。

## 400或Invalid request

通常需要检查请求字段、所用协议、消息/工具格式，不能仅凭状态码判断是谁的故障。保留请求ID，不反复重试相同请求。图片先核对`quality`；Kiro积分先核对Messages与工具参数。

## 429或503

可能是限流或临时容量不足。若有`Retry-After`，按指定时间等待。只对明确未执行且适合重试的请求做有上限退避；已经输出、中途断流或视频提交结果不明时，先查状态，不自动重发。

## 断流是不是没扣费

不一定。已经生成的内容、有效用量或工具调用可能产生费用。HTTP 200、首包和结束事件也不是同一个概念。提供请求ID、时间和模型给客服，不能用“没看到最后一句”直接推断零费用。

部分 Claude 文本请求完整发出后、在收到响应前由客户端取消且没有实际用量，会按本地输入 Token 估算结算，并在账单注明。未发出的请求不收这笔费用，历史请求不补扣；范围见[请求取消与输入估算](/docs/markdown/billing.md#请求取消与输入估算)。

## Magpie会不会影响原配置

给应用分配模型会修改对应应用的接入配置。当前任务还在进行时，只添加供应商，不切换。若导入时提示替换已有供应商，先取消；不要同时让其他配置工具接管同一个应用。

## 本地显示费用与本站不同

本地工具可能采用官方美元价格、默认模型价或自己的统计估算。以本站所选组的现行价格与使用记录为准。图片、视频和credit不是普通文本Token计费，不能直接套用。

## 分组倍率变高，是不是一定更贵

不一定。2026-11-03 同时调整了文本基础单价与分组倍率，不能只看倍率变化；请在模型广场选择实际使用的组，对照输入、输出和缓存最终单价。已有密钥无需重建，图片和积分规则不变。详见[价格与用量](/docs/markdown/billing.md)。

## 能不能保证全部模型长期可用

不能。模型发现与一次历史成功都不是持续可用性保证。文档列明[历史核验范围](/docs/markdown/verification.md)，实时容量和错误仍要按当次请求判断。

## 客服需要什么信息

添加[微信客服「懒小懒」](/docs/markdown/support.md)，提供时间与时区、完整模型名、分组、状态码、请求ID、客户端版本。截图遮住密钥、密码、邮箱、余额和私人对话。本文不承诺未公布的客服时间、退款规则或数据留存期限。

## 代理需要自己买服务器吗

托管分站不需要。自备域名，先连接账号、验证解析，再付一次开通费；模型用量另计。分站注册、品牌和收款在自己的后台设置，详见[分站开通教程](/docs/markdown/partners.md)。

---

# 选择分组和模型

分组决定路由、计费规则及密钥可用范围。同名模型在不同组的价格与可用性可能不同；倍率低不等于任何情况下总价都更低，必须连同模型基础价、单位和阶梯一起看。

创建密钥时，分组按模型系列分类，同类按倍率从高到低排列；可以搜索名称、说明或倍率。名称更新不影响已有密钥，无需修改客户端。

## 按用途选择

新接入推荐：**Claude 选择自制号池，GPT 选择「GPT 神秘渠道」**。先在[模型广场](https://otz.si/pricing)选择分组，确认目标模型和价格，再创建对应分组的密钥。

Claude 自制号池包括「自制cc pro+max 混合号池」和「自制cc-pro号池」，按目标模型的当前可用范围选择；“自制号池”是分组名称，不代表本站自营。若模型广场或创建密钥时未显示该组，先联系站内客服，不要用其他分组密钥代替。

另有「自制cc-pro号池 周末特惠」独立分组，需单独创建对应密钥，不与常规 Pro 池混用。开放时间、模型及价格见[模型广场](https://otz.si/pricing)。

| 系列或用途 | 选择要点 | 接入方式 |
| --- | --- | --- |
| Claude | 优先自制号池；与「Claude Kiro 积分」等其他组分别选择，不混用计费单位 | Claude Code优先原生Messages |
| GPT | 优先「GPT 神秘渠道」；确认该组支持的完整GPT模型名 | Codex优先Responses；其他客户端按支持协议 |
| Gemini / Grok | 确认完整模型名和支持端点，勿只看系列 | 本指南文本示例使用兼容Chat；原生协议需另核对 |
| 国产文本 | DeepSeek、GLM、Kimi、MiniMax等按具体模型选 | 以模型广场显示的协议为准 |
| 图片 | GPT图片密钥、图片生成模型 | Images接口，不是普通Chat |
| 视频 | Seedance / MiniMax视频分组 | 异步Videos接口 |
| GPT不限量 | 权益以所购套餐为准 | 不代表图片、视频和其他组免费 |

## 模型名从哪里复制

1. 模型广场先选择密钥所属分组。
2. 复制完整模型ID，包括连字符、点号、大小写和日期后缀。
3. 在客户端粘贴，不把界面的简称当API名称。

例如 `gpt-6.1-sol` 与 `gpt-6-sol` 不是同一个模型；`claude-sonnet-5-5` 与带点的名称也不能自行视为等价。不要在没有明确说明时删除日期或自动换代。

客户端下拉列表可能来自账户总目录，不一定等于这枚密钥的最终权限。需要确认时，用该密钥读取一次 [模型列表](/docs/markdown/api.md#免计费模型发现)。列表中有模型仍不保证此刻有生成容量。

## 多个分组怎样配置

需要分别选择多个组时，每个组建立独立的客户端供应商，例如「懒人AI-GPT神秘」「懒人AI-Claude自制混合池」，分别填对应密钥。推荐不代表旧组下线；已有配置正常就保留。切换时另建对应分组的密钥和供应商，不覆盖旧配置，也不要设置失败后偷偷换到不同计费组。

先完成当前任务，再切换模型或供应商。旧会话可能包含其他模型的工具或推理状态；改完后先开新会话更容易判断配置是否正确。

---

# 生成图片

使用「GPT 图片」分组对应的密钥，调用图片生成接口。使用 Magpie 时，先在 [Magpie 教程](/docs/markdown/magpie.md) 添加「懒人AI · 图片」供应商。

**已实测：** 2026-10-28，Magpie 0.1.1888 本地 Images API → 懒人AI，`gpt-image-2` 返回 1 张 1024×1024 图片，用时约 56 秒，本站实际扣费 **¥0.05**。这次验证没有经过 Agent 聊天生图/MCP，也不代表所有模型、尺寸都已测过。

下面是直接 API 接入步骤，可交给你的 AI 执行。若经 Magpie 本地 API 调用，地址与模型前缀应使用你本机实际配置，不能照抄本站直连接口的密钥与模型写法。

## 模型与尺寸

四款完整名称为`gpt-image-2`、`gpt-image-2.5`、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`。[统一单张价格见这里](/docs/markdown/billing.md#gpt图片)，1K/2K/4K不再对应不同收费档。

`size`使用像素字符串，例如`1024x1024`，不要把`1K`直接当作所有接口均接受的值。2K/4K请求也必须使用该模型实际支持的尺寸；没有确认的尺寸列表不要猜填。返回像素和细节可能不等于请求值，下载后检查实际图片尺寸。

## 1 准备最小请求

保存为`image.json`：

```json
{
  "model": "gpt-image-2",
  "prompt": "一只戴紫色围巾的橘猫，简洁插画，无文字",
  "size": "1024x1024",
  "n": 1
}
```

`gpt-image-2`先不传`quality`，不要擅自填`standard`、`hd`或`4k`。三款2.5在本站2026-10-27的单张测试使用`quality: "low"`；换模型时按其说明填写，不把所有模型强行统一参数。

## 2 只提交一次

下载 [request.py](/docs/examples/request.py)，执行：

```sh
python3 request.py /v1/images/generations --json image.json --allow-charge --out image-result.json
```

程序隐藏输入密钥，提示确认后才提交。结果文件仅保存在本机，不覆盖同名文件。生成可能需要等待；超时并不证明没有生成或扣费，先查使用记录，不盲目重试。

## 3 保存图片

常见结果为`data`数组，元素中包含`b64_json`或`url`，以实际响应为准。

如果是`b64_json`，在本机执行：

```python
import base64
import json
from pathlib import Path

result = json.loads(Path("image-result.json").read_text(encoding="utf-8"))
for index, item in enumerate(result["data"], start=1):
    if not item.get("b64_json"):
        print(f"第{index}张使用URL返回，请在本机查看结果文件。")
        continue
    raw = base64.b64decode(item["b64_json"], validate=True)
    suffix = ".png" if raw.startswith(b"\x89PNG") else ".jpg" if raw.startswith(b"\xff\xd8\xff") else ".webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else ".bin"
    with open(f"image-{index}{suffix}", "xb") as output:
        output.write(raw)
```

如果是URL，用浏览器打开返回地址及时保存；**不要把本站Authorization请求头转发给图片托管域名**。图片URL可能具有临时访问权限，不要公开分享原链接。

## 常见问题

- **返回了文字没有图片：** 检查是否错用了Chat接口。
- **quality参数错误：** 先按以上最小参数使用，不自动做参数排列组合测试。
- **实际尺寸不同：** 以文件像素为准。Flare在历史1K请求中曾返回1254×1254，不能承诺严格尺寸。
- **想编辑图片：** 本页仅覆盖已核对的生成接口，不代表所有模型支持`images/edits`或multipart上传。

历史测试范围见[核验记录](/docs/markdown/verification.md)，不是实时可用性保证。

---

# 懒人AI文档首页


本站 API 主地址为 **https://otz.si**。Magpie 与 DSH 均填写主域名，不必手动加 `/v1`；程序请求使用对应教程的完整接口路径。

文档核对日期：2026-10-28。模型、价格和权限以当前账户的模型广场与使用记录为准；[查看核验范围](/docs/markdown/verification.md)。

---

# Kiro积分组的接入与扣费

「Claude Kiro 积分」与普通Kiro Token组是不同分组。请使用积分组密钥及其支持的完整Claude模型名，优先选择 **Anthropic Messages**。

## 接口和客户端

- 完整接口：`POST https://otz.si/v1/messages`。
- Magpie的Anthropic根地址：`https://otz.si`，使用[Claude接入入口](/docs/markdown/magpie.md)。
- 不要用Chat Completions桥接后，假设仍保留积分字段、所有工具事件及原有会话状态。
- Magpie原生Messages路线可配置，但本站尚未完成其积分端到端专项核验；不要把配置完成当作credit、工具和旧会话均已验证。

最小Messages请求示例见[API教程](/docs/markdown/api.md#anthropic-messages)。先选该密钥支持的模型，不把其他组的模型目录直接复制过来。

## 如何查看扣费

现行单价与计算示例集中在[价格说明](/docs/markdown/billing.md#kiro积分)。在本站使用记录中查看credit、工具费和最终金额，不按客户端显示的普通Token估价判断。

接入方若把本站作为上游转售，必须单独确认其网关能保留并识别`provider_usage.credits`：非流式为响应顶层，流式为最终`message_delta`事件中的字段。不能把缺失、无效值当作合法0，也不能自动改用Token估算。本站计费记录与客户端是否展示该扩展字段是不同问题，不要仅凭客户端没有显示credit就判断免费。

## credit为0与错误请求

合法credit=0且没有工具费时没有积分费用；已执行的搜索工具可能单独收费。请求报错、连接中断和取消，不等于一定没有产生用量。对结果有疑问时，先用请求ID查询账单，不要通过重复请求验证。

## Invalid request / HTTP 400

先确认完整模型名、Messages协议、密钥分组以及工具参数。若旧会话报错、新会话可用，保留原会话，使用一条最短的新会话区分配置问题和历史消息兼容问题；发送它仍会产生正常用量。

不要删除客户聊天记录、关闭安全检查、去掉全部工具结果或自动换模型“修好”报错。部分历史400只取得了通用错误，不能据此承诺已经查明或修复所有请求参数问题。提供请求ID给客服进一步定位。

---

# Magpie 接入懒人AI

只添加懒人AI，不用选择内置商家，也不用配置路由组。

## 1 下载并打开

前往 [Magpie 官网](https://usemagpie.ai/zh/) 下载并安装。要用 Codex 或 Claude，也先装好对应应用：

| 应用 | Mac | Windows |
| --- | --- | --- |
| Codex（在 ChatGPT 应用内） | [ChatGPT 官网下载](https://chatgpt.com/download/) | 打开微软商店，搜索 **ChatGPT**，认准 **OpenAI** |
| Claude | [Claude 官网下载](https://claude.com/download) | 打开微软商店，搜索 **Claude**，认准 **Anthropic**；也可从官网下载 |

已安装就跳过。装好后继续下面两步接入；不要下载同名第三方客户端。

## 2 添加懒人AI，填自己的密钥

新建密钥时，Claude 推荐自制号池，GPT 推荐「GPT 神秘渠道」；先按[分组说明](/docs/markdown/groups.md)确认模型和价格。下面的导入入口只填客户端地址，不会替你选择分组或改变密钥权限。

按你要使用的模型，点一个入口：

- **[添加懒人AI · GPT](https://usemagpie.ai/import#name=%E6%87%92%E4%BA%BAAI-GPT&id=lanren-gpt&chat=https%3A%2F%2Fotz.si&responses=https%3A%2F%2Fotz.si&website=https%3A%2F%2Fotz.si)**
- **[添加懒人AI · Claude](https://usemagpie.ai/import#name=%E6%87%92%E4%BA%BAAI-Claude&id=lanren-claude&anthropic=https%3A%2F%2Fotz.si&website=https%3A%2F%2Fotz.si)**
- **[添加懒人AI · 国产文本](https://usemagpie.ai/import#name=%E6%87%92%E4%BA%BAAI-%E5%9B%BD%E4%BA%A7%E6%96%87%E6%9C%AC&id=lanren-domestic&chat=https%3A%2F%2Fotz.si&website=https%3A%2F%2Fotz.si)**：DeepSeek、GLM、Kimi、MiniMax 等文本模型。
- **[添加懒人AI · 图片](https://usemagpie.ai/import#name=%E6%87%92%E4%BA%BAAI-%E5%9B%BE%E7%89%87&id=lanren-images&chat=https%3A%2F%2Fotz.si&website=https%3A%2F%2Fotz.si)**：填写「GPT 图片」组密钥，后续生成步骤看 [图片教程](/docs/markdown/images.md)。
- **[视频接入](/docs/markdown/videos.md)**：Seedance / MiniMax，提交任务后查询、下载。

前三个入口用于文本。图片已验证 Magpie 本地 Images API 转发；这不等于 Agent 聊天生图也已验证。视频仍按独立 API 教程接入。

允许浏览器打开 Magpie；确认地址属于 **otz.si**，粘贴你在本站 [API 密钥](https://otz.si/keys) 页创建的对应分组密钥，点 **添加**。不是填网站登录密码。

入口只预填公开地址，不含密钥。若提示替换已有供应商，先取消，避免覆盖原配置。

添加时会获取该密钥可用的模型，不用逐个手填。不同分组使用各自的密钥；同系列要添加多个分组时，分别命名并保留原配置。

::: details 链接打不开？手动添加
打开「供应商」→「＋ 添加供应商」→「自定义」，填写：

| 填写项 | GPT | Claude |
| --- | --- | --- |
| 名称 | 懒人AI-GPT | 懒人AI-Claude |
| OpenAI Responses 地址 | `https://otz.si` | 不填 |
| OpenAI Chat 地址 | `https://otz.si`（所选组支持Chat时） | 不填 |
| Anthropic 地址 | 不填 | `https://otz.si` |
| API Key | 对应GPT分组的本站密钥 | 对应Claude分组的本站密钥 |

国产文本：名称填「懒人AI-国产文本」，只填 **OpenAI Chat 地址 `https://otz.si`** 和对应国产分组密钥，其余接口留空。

图片：名称填「懒人AI-图片」，同样填 OpenAI 兼容地址 `https://otz.si`，密钥改为「GPT 图片」组；生成请求使用 Images 接口，不是 Chat。

只填本次需要的接口。本站已兼容无前缀调用，统一填主域名，不用手动加`/v1`；已有带`/v1`且正常的配置也不用改。[Magpie官方字段说明](https://usemagpie.ai/docs/zh/import)中的通用示例不等于本站必须加前缀。
:::

## 3 给应用选模型，开始使用

进入 **Agent** 页，找到你要用的应用，点它当前的模型，选择 **懒人AI** 下有权限的完整模型名。不要选自动路由组。

**等当前任务结束后再切换**，按提示重新打开目标应用或终端，新建会话。使用期间保持 Magpie 运行，不要同时让其他配置工具管理同一个应用。

![Magpie接入填写示意：添加懒人AI，粘贴对应分组密钥，再给目标应用选择模型。此图不是客户端截图。](/docs/assets/magpie-flow.svg)

接好后，更多用法可以直接问你的 AI，或看 [官方快速上手](https://usemagpie.ai/docs/zh/start)。发消息按本站所选分组计费，无需测试全部模型。

<small>已核对官方流程和无密钥导入链接；2026-10-28 经 Magpie 0.1.1888 本地 Images API 成功生成 1 张 gpt-image-2 图片，1024×1024，本站扣费 ¥0.05。未逐一实测文本应用、Agent 生图/MCP、其他图片模型或视频。Kiro积分在Magpie中的兼容尚未验证，不要跨协议转换；它需要保留原生Messages路线。</small>

---

# 开通自己的 AI 分站

入口：[懒人AI 分站](https://partners.otz.si/partners)。一次性 ¥288，永久开通、无月费；不用另外购买服务器。域名由你自备，开通费不包含模型调用余额。

## 先配置 再付款

1. 在分站门户注册账号并验证邮箱，点击「开始配置分站」。不会立即扣款。
2. 连接自己的懒人AI账号，完成下面的域名验证。
3. 配置检查通过后，点击「付款开通」。付款确认后自动部署、同步模型并配置 HTTPS；全部完成才显示「已开通」。首次同步需要几分钟，不要重复付款。

## 连接账号

登录 [懒人AI](https://otz.si)，打开「安全与访问 → 访问令牌」，新建分站专用令牌，只选择：

- 个人资料：查看。
- API 密钥：查看、创建/修改、显示密钥。

把令牌填入门户的「懒人AI 专用访问令牌」，设置分站售价系数，阅读授权范围后点击「验证并连接账号」。不需要余额、支付或管理员权限；不要把令牌发到聊天里。

程序会创建本分站专用的调用密钥，模型费用从你自己的主站余额扣除。售价系数按目标值计算，不会因反复同步叠加。访问令牌到期或撤销后需要在门户重新连接，不要删除已有分站后重新购买。

## 绑定域名

填写你持有的域名，例如 `ai.example.com`，点击「获取解析要求」。在域名服务商后台添加页面给出的 A 记录和 TXT 记录，再点击「核对解析」。

当前要求 IPv4 直接解析；不要开启 CDN 代理，也不要保留同名 AAAA 记录。TXT 验证信息首次有效期为 1 小时，过期后重新获取。不要改动域名上其他业务的记录。

## 开通后

在「我的分站」打开网站。查看初始管理账号时，需要再次输入**分站门户的登录密码**；登录分站后台后及时修改初始密码。

网站名称、品牌、客户注册和分站收款由你在自己的后台设置。初始客户注册关闭，**不会自动复制主站支付商户配置**。分站客户的余额与你的主站余额是两本独立账本，不会相互充值。

已就绪分站每 5 分钟核对一次目录，也可点击「立即核对并同步」。支持文本、图片，以及当前已适配的视频和积分计费；未知计费或配置冲突会暂停同步并显示原因。

导入模型使用独立调用名以隔离定价，通常带有 `__lr_` 后缀。客户应从自己分站的模型列表复制完整名称，不要删掉后缀。视频按任务规则结算，积分按实际 credit 结算，不套普通文本价格。

## 出现异常

- **已付款但未开通**：查看门户状态，联系[客服](/docs/markdown/support.md)，不要重复付款或重新建单。
- **同步已暂停**：按提示检查令牌有效期或配置改动。不要直接删掉同步渠道、密钥或价格来重试。
- **域名不通过**：核对 A、TXT、AAAA 和 CDN 设置，等待解析生效后重新核对。
- **模型调用失败**：先核对主站余额、分站余额、密钥分组和完整模型名；保留请求 ID，不反复提交可能收费的任务。

部署、真实目录导入及重复同步已核对；视频和积分结算使用隔离模拟数据验证。模型容量和生成结果仍以实际调用为准。

---

# 第一次使用懒人AI

你需要准备自己的懒人AI账户、调用密钥，以及要使用的应用。网站登录密码不是API密钥；ChatGPT或Claude的会员也不等于本站余额。

![从选择分组到接入应用的流程示意](/docs/assets/start-flow.svg)

## 1 选择用途和分组

打开 [懒人AI](https://otz.si)，登录后进入「模型广场」。先选择分组，再确认完整模型名、接口和价格。

- Claude：推荐自制号池，具体分组见[选择分组和模型](/docs/markdown/groups.md)。
- GPT / Codex：推荐「GPT 神秘渠道」，确认该组支持你要用的模型。
- 其他文本：选支持目标模型的文本组。
- 图片：选「GPT 图片」组。
- 视频：选对应的Seedance或MiniMax视频组。
- Kiro积分：是按credit计费的独立组，不等同于普通Kiro Token组。

分组不是纯标签，它决定密钥能使用的路由与模型。不要仅凭“Claude”“GPT”几个字猜测所有模型都能调用。详见[分组说明](/docs/markdown/groups.md)。

## 2 创建自己的密钥

在控制台「API密钥」页面新建密钥，设置易懂的名字，例如「笔记本-Claude」；选择刚才确认的组，并按需要设置额度、有效期和模型限制。

只把密钥粘贴到你信任的客户端秘密字段。不要发给客服、写到教程、放进Git，或出现在截图中。换电脑、分组或客户端时，建议使用独立密钥，便于单独停用。

## 3 选一条接入路线

| 你想做什么 | 下一步 |
| --- | --- |
| 编程、文本，或给多个应用统一选模型 | [Magpie 一键接入](/docs/markdown/magpie.md) |
| 已在使用 DeepSeek Harness（DSH） | [直接添加懒人AI](/docs/markdown/dsh.md) |
| 在自己的程序中调用 | [API接入](/docs/markdown/api.md) |
| 生成图片或视频 | [图片](/docs/markdown/images.md) / [视频](/docs/markdown/videos.md) |

Magpie负责接入与选模型，目标应用仍需安装：[Codex / Claude 官方下载与 Windows 商店说明](/docs/markdown/magpie.md#_1-下载并打开)。不要同时让其他配置工具管理同一个应用。

## 4 核对配置即可，不必反复测试

地址、协议、分组和模型名核对正确后，保存配置。模型发现只检查名称与权限，不等于生成成功。

需要实际验证时，先看价格和密钥额度，只发一条最短文本，或一张图片；视频提交后等待同一个任务，不连续重提。所有生成请求都可能收费，客户端“测试全部模型”也可能收费。

## 5 遇到问题

先看[常见问题](/docs/markdown/faq.md)。联系网站客服时提供请求ID、时间、模型名和状态码即可，不要提供完整密钥、密码或私人对话内容。

---

# 联系客服 · 懒小懒

接入不会配、调用报错或充值有疑问，可以添加微信客服 **懒小懒**。

用微信扫一扫，或保存下方图片后在微信里识别二维码。

<img src="/docs/assets/support-wechat.jpg" alt="微信客服懒小懒的好友二维码" width="328" style="max-width:100%;height:auto;border-radius:16px" />

[打开二维码原图](/docs/assets/support-wechat.jpg)

## 提问时带上这些就够了

- 接入问题：使用的软件、模型完整名称，以及报错截图。
- 调用或扣费问题：大概时间、分组、模型名和请求 ID。
- 充值问题：订单号和付款时间；不要重复付款。

**不要发送登录密码、API 密钥、登录验证码或钱包私钥。** 截图先遮住这些内容，也不需要发送私人对话。

## 绑定后，微信发「余额」就能查

1. 登录[安全与访问](https://otz.si/security)，在「账户绑定 → 微信客服」点击 **获取绑定码**，按网站提示完成安全验证。
2. 复制整行 `绑定 …`，**私聊发给上面二维码对应的懒小懒**，收到「绑定好了」就完成了。网站会自动更新状态，不用再点击确认。绑定码 5 分钟有效、只能用一次，不要发群里或给其他人。
3. 以后私聊发 **余额** 或 **帮我查一下余额**，就能查询自己的站内余额。不需要发送 API 密钥，也不会改变你原来的模型配置。

只绑定自己的微信和站内账号；这不是微信登录。需要解除时，回到同一页面点击「解绑」。

## 微信转账充值

向客服本人转账，系统核实 **已确认收款** 后，按 **实收 ¥1 = 站内余额 ¥1** 入账，无额外赠送；单笔自动入账上限 **¥100**。支持私聊及客服所在群内向客服本人发起的转账，红包、转给其他人、付款截图或一句「我已付款」不能自动入账。

- **先转账、还没绑定：** 款项会保留为待绑定。同一个付款微信完成绑定后再处理，不要重新转钱。
- **超过 ¥100、回执不完整或服务暂时离线：** 请联系站主核对，不承诺自动入账或固定到账秒数。
- **查是否到账：** 完成站内入账后会收到微信通知；也可以发 **到账了吗** 查看已识别转账的处理状态，发 **余额** 或到[钱包](https://otz.si/wallet)查看。微信已收款不等于站内已经入账；没有识别到记录时，提供金额和时间交站主核查，不要重复支付。

原网站支付宝、微信和 USDT 收款方式保持不变。**2026-10-30** 修复微信绑定/余额回复及私聊转账识别，增加网页自动更新。已核对真实私聊卡片格式，并用模拟数据验证入账与重复回执处理；修复后新转账的完整到账通知仍待真实使用确认，不将历史测试转账补入客户余额。

不知道从哪开始？先看[三步快速接入](/docs/markdown/quickstart.md)，不必通读整站教程。

---

# 核验范围与文档更新

更新日期：2026-10-28，Asia/Shanghai。

## 本版依据

| 内容 | 已核对的范围 | 不能据此推断 |
| --- | --- | --- |
| 无前缀地址兼容 | 10月28日核对服务器转发；Models、Responses、Chat带/不带`/v1`的6条无密钥探针均返回JSON 401，没有404或重定向 | 已通过密钥鉴权、模型生成或客户端端到端验证 |
| Magpie | 官方配置/导入协议，GPT、Claude、国产文本、图片的公开无密钥链接；0.1.1888 本地 Images API 实测 gpt-image-2，1张1024×1024，约56秒，本站扣费¥0.05 | Agent聊天生图/MCP、其他模型/尺寸、视频、工具和credit均端到端兼容 |
| DSH | DeepSeek官网链接的官方模型配置指南，自定义提供商、协议、模型发现及选择流程 | 本轮在DSH发起过生成，或所有模型/工具均兼容 |
| 客户端下载 | 10月28日核对 OpenAI 官方桌面应用说明及 Claude 官方下载页；补充 Mac 官网入口和 Windows 微软商店名称 | 本轮重新安装、切换或实测了这些客户端 |
| 图片 | 10月27日四款模型各一次1K请求，均有图片；Flare实际尺寸不符 | 所有尺寸均严格匹配或实时可用 |
| 文本与图片 | 10月27日18个非视频分组、141个模型与分组组合中135项严格通过；另1项图片尺寸例外、5项没有完整成功 | 长期SLA、所有旧别名或所有客户端支持 |
| 视频 | 已有历史任务完成/下载记录；当前插件参数与接口核对 | 本轮重新生成成功、固定完成时间 |
| 价格 | 截至10月28日的本站变更记录：图片统一价、Kiro积分/工具费等 | 本地第三方工具显示的估算必然等于本站账单 |

历史样本不是实时状态。部分Claude路由曾出现502/503，GPT Pro曾出现超时；视频有提交超时记录。具体请求按模型、分组和请求ID定位，不能把文档列表当作可用性承诺。

## 本次教程制作的边界

文档验证覆盖链接、示例语法、静态构建、网页布局、独立发布及上述免计费路由。教程已发布到本站`/docs/`，有新版本时当前教程页会自动刷新；不会刷新控制台或修改客户端配置。保留Magpie与DSH教程；原CC Switch教程下线、旧地址引导至Magpie。

10月28日经用户本轮批准，在已安装的Magpie中添加临时图片供应商，仅发1次图片请求、本站扣费¥0.05；结束已停用测试密钥及临时供应商。未改本机Codex配置、当前应用模型、Magpie默认生图模型或系统代理。DSH仅核对官方文档，没有安装、配置或发起请求；没有视频重测或真实支付。

页面里的操作图为标明用途的示意图，不是伪造的实际成功截图。真实客户端按钮可能随版本变化，以当时官方版本和界面为准。

## 官方参考

- [Magpie快速上手](https://usemagpie.ai/docs/zh/start)
- [Magpie导入机制](https://usemagpie.ai/docs/zh/import)
- [Magpie API 参考](https://github.com/yetone/magpie/blob/main/docs/reference.md)
- [DeepSeek Harness 官方模型配置](https://deepseek-harness.github.io/deepseek-harness/guide/providers)
- [Codex高级配置](https://developers.openai.com/codex/config-advanced/)
- [OpenAI桌面应用说明](https://developers.openai.com/codex/app)
- [Claude官方下载](https://claude.com/download)

教程中的本站地址、价格、分组和模型权限以懒人AI自身说明为准，不把第三方示例域名、美元价格或示例模型当作本站配置。

---

# 生成视频

视频是异步任务：**提交一次，保存ID，查询同一任务，成功后下载。** 不要通过重复提交来“刷新进度”。

![异步视频任务的提交、等待、下载和异常处理示意](/docs/assets/video-flow.svg)

## 模型与参数

以下范围按本站现有视频插件1.0.2核对；有权限不等于实时有容量。

| 完整模型名 | resolution | 整数时长seconds |
| --- | --- | --- |
| `doubao-seedance-2-0` | `720p` / `1080p` / `4k` | 4–15 |
| `doubao-seedance-2-0-fast` | `720p` | 4–15 |
| `doubao-seedance-2-0-mini` | `720p` | 4–15 |
| `doubao-seedance-2-5` | `720p` / `1080p` | 4–30 |
| `MiniMax-H3` | `720p` / `1080p` / `2k` / `4k` | 5–15 |
| `MiniMax-H3-Fast` | `720p` / `1080p` / `2k` / `4k` | 5–15 |

使用对应视频分组的密钥。`ratio`支持`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`。大小写及完整模型名按表填写。

## 1 提交任务

将以下内容保存为`video.json`：

```json
{
  "model": "doubao-seedance-2-0",
  "prompt": "一只橘猫缓慢走过洒满阳光的窗台，镜头平稳，无文字",
  "seconds": 4,
  "resolution": "720p",
  "ratio": "16:9"
}
```

下载 [request.py](/docs/examples/request.py)，执行一次：

```sh
python3 request.py /v1/videos --json video.json --allow-charge --out video-task.json
```

提交成功后，从结果中保存`id`（部分响应使用`task_id`）。这是之后查询和下载要用的客户端任务ID，不要从其他平台复制一个任务号替代。

若没有取得任务ID或提交超时，记录请求ID和时间，先查本站任务/账单或联系客服，不立刻重提。即使程序没有拿到响应，服务端也可能已经接单。

## 2 查询同一个任务

把`TASK_ID`替换为刚才获得的ID：

```sh
python3 request.py /v1/videos/TASK_ID
```

`queued`、`pending`、`in_progress`、`processing`或`running`表示尚未完成；`completed`或`succeeded`表示成功；`failed`或`cancelled`表示终态失败。遇到陌生状态先保留，不按成功处理。

手动或程序每隔约10–30秒查一次即可；这个间隔是客户端建议，不是服务的频率上限承诺。可以稍后继续查同一ID，不需要始终开着提交窗口。多分钟等待并不罕见，不能把固定30秒当作失败界限。

## 3 成功后下载

```sh
python3 request.py /v1/videos/TASK_ID/content --out video.mp4
```

使用同一密钥从本站内容接口获取视频。检查文件可播放、时长及尺寸，再确认任务完成。不要把密钥发到第三方下载地址。

## 参考图与暂不支持的参数

本站插件接受JSON请求，参考图使用可访问的HTTPS URL放在`image`或`images`字段；不是直接提交本机文件路径，也不是multipart。仅使用你有权上传的非敏感图片。参考图字段的具体模型兼容性与数量限制须按当前模型说明确认，本页默认例子是文生视频。

**当前不接收参考视频字段**，包括`video`、`video_url`、`reference_video`等；不要凭别的平台文档照搬。其余高级metadata选项只在有明确模型说明时使用。

## 计费与异常

提交前先看[视频计费说明](/docs/markdown/billing.md#视频)和模型广场。分辨率、秒数和模型都会影响价格；不要把普通Token目录价误当视频价。任务可能先预扣、后结算，失败/退款以账单和任务终态为准，不承诺所有网络错误立即退款。

历史样本曾有提交超时及较长等待。教程不承诺固定完成时间，也不自动重试可能已计费的提交。

---