Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

easyapi-studio

/easyapi-studio

Generuje obrazy, wideo i odpowiedzi tekstowe przez bramkę modeli EasyAPI, a także sprawdza parametry i ceny modeli.

Repozytorium
easyapi-skill ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
12
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/easyapi.py

Co robi i kiedy

Generuje obrazy, wideo i odpowiedzi tekstowe przez bramkę modeli EasyAPI, a także sprawdza parametry i ceny modeli.

Oryginalny opis (EN)

通过 EasyAPI 模型网关生成图片、生成视频、文本与多模态对话,并查询可用模型、模型参数与价格。当用户要生成图片、生成视频、文生图、图生图、文生视频、图生视频、首尾帧生成视频、用 EasyAPI 调用模型、查询模型参数、比较模型价格、查询 API Key 余额额度时使用。Use when the user wants to generate images or videos, call the EasyAPI model gateway, look up model parameters, compare model prices, or check API key quota.

Jak działa

  1. 0. 先确定调用入口(每次会话第一步)
  2. 1. 两条纪律
  3. 2. 按用户意图选命令
  4. 3. 模型怎么选、钱怎么花
  5. 4. 首次使用:确认 key
  6. 5. 配置完成后怎么回复用户
  7. 6. 生图
  8. 7. 生视频
  9. 8. 把结果给用户看(预览优先)
  10. 9. 查参数(不确定就查,别猜)
Sekcje z nagłówków SKILL.md, w oryginale · 401 linii, 1 243 słów
Podgląd SKILL.md
---
name: easyapi-studio
description: 通过 EasyAPI 模型网关生成图片、生成视频、文本与多模态对话,并查询可用模型、模型参数与价格。当用户要生成图片、生成视频、文生图、图生图、文生视频、图生视频、首尾帧生成视频、用 EasyAPI 调用模型、查询模型参数、比较模型价格、查询 API Key 余额额度时使用。Use when the user wants to generate images or videos, call the EasyAPI model gateway, look up model parameters, compare model prices, or check API key quota.
---

# EasyAPI 创作(图片 / 视频 / 对话)

所有网关请求都通过本 skill 的脚本发,**不要手工拼 curl 或 JSON**。
只想配置 key、不生成内容时用 `easyapi-auth` 技能;本技能也保留登录入口(`login`),
两个技能共用同一份 `~/.easyapi/config.json`。

## 0. 先确定调用入口(每次会话第一步)

本文件所在目录记为 `EASYAPI_SKILL_DIR`。skill 可能被安装在任意位置(插件目录、
`~/.claude/skills`、`~/.codex/skills`…),所以**一律用绝对路径调用启动器**,
不要写 `python3 scripts/easyapi.py`——cwd 不一定是 skill 目录。

```bash
EASYAPI_SKILL_DIR="<本 SKILL.md 所在目录的绝对路径>"
"$EASYAPI_SKILL_DIR/bin/easyapi" env --network
```

`bin/easyapi` 会自己探测 `python3` → `python` → `py -3`,再执行 `scripts/easyapi.py`
(仅 Python 3.7+ 标准库,无需 pip)。`env --network` 一次输出:解释器与版本、
skill 目录、配置目录、内置快照日期、网关连通性、`/pricing/schema` 是否可用。

**没有 Python 时**:如实告诉用户,并按 `references/fallback-curl.md` 的固定配方调用。
降级路径不做参数预校验,必须**先查 schema 再发送**。

## 1. 两条纪律

### 凭据永远不进对话——但授权命令应当由你代跑

原则:**任何 key / 密码 / 令牌都不经过对话**;能由你代跑的就代跑,不要把终端操作推给用户。

**首选:你直接运行浏览器授权**。用户只需在弹出的网页里点一下「授权」,全程零终端输入:

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" login --browser
```

- **Bash 超时给足 6 分钟**(脚本最长等 5 分钟授权,默认 2 分钟会打断用户操作)
- 没弹出浏览器时,把 stderr 里的「授权页地址」转成链接发给用户
- 平台未部署 CLI 授权端点时脚本会明确报「不支持网页授权」,此时改用密码模式
- 脚本与用户浏览器必须同机(桌面 agent 场景成立);远程主机退回密码模式

**密码模式(兜底)**:`login` 需要交互输密码,而你的 shell 没有 TTY,密码经过你就等于
进入对话——这一种必须由用户在自己的终端运行:

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" login
```

**唯一例外**:用户已主动把 key 贴在对话里。用 `login --api-key` 通过 stdin 写入,
然后**明确提醒他该 key 已出现在对话记录中,建议用完后到 https://www.easyapi.com 删除重建**。

### 不要让模型自己拼 JSON 或写轮询循环

脚本内置参数校验、异步轮询、结果下载、错误翻译;手工做这些正是出错的主要来源。

- 不确定请求长什么样 → 加 `--dry-run` 看脚本生成的请求体(不发请求、不需要 key)
- 生视频要等很久 → 脚本自己轮询到完成,**不要** `--no-wait` 后自己写循环

## 2. 按用户意图选命令

| 用户想做 | 命令 | 需要 key |
|---|---|---|
| 画图 / 改图 / 换风格 | `image` | ✅ |
| 生成视频 / 首尾帧 / 参考素材 | `video` | ✅ |
| 文字问答 / 看图问答 | `chat` | ✅ |
| 有哪些模型 / 哪个便宜 | `models` / `compare` | ❌ |
| 该用哪个模型(按能力+价格给候选) | `recommend` | ❌ |
| 某模型收哪些参数 | `schema` | ❌ |
| 配 key / 查余额 | `login` / `quota` | — |
| 环境或接口不对 | `env --network` | — |

通用开关:`--json`(机器可读)、`--refresh`(忽略缓存)、`--dry-run`(只校验不发请求)、
`--strict`(定义外的参数直接报错)、`--param key=value`(透传厂商特有参数)。

## 3. 模型怎么选、钱怎么花

**永远不要把几十个模型倒给用户。** 按这个顺序解析模型:

| 优先级 | 依据 | 行为 |
|---|---|---|
| 1 | 用户本轮点名(「用 Kling-3.0 做…」) | 原样使用;模型不存在就报错并列候选,**不回退默认** |
| 2 | 本次会话刚选过同类模型 | 沿用,并说一句「继续用刚才的 X」 |
| 3 | 用户配置的默认(`config --default-image-model` / `--default-video-model`) | 使用,并在结果里注明「模型:X(默认)」 |
| 4 | 什么都没配过 | 用**内置默认**:图片 `qwen-image-3.0-pro`,视频 `wan3.0-video`;结果里注明「(默认)」 |
| 5 | 用户说「随便 / 你定」 | 用内置默认(或 `recommend` 的首选),说明理由与预估价格,允许反悔 |

内置默认覆盖大多数日常需求,**不要为了选模型停下来问**。只有当请求明显需要默认模型没有的
能力(参考视频、首尾帧、超长时长等)时,才用 `recommend --need ...` 给 1~3 个候选让用户挑。

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" recommend --category video \
  --need first-last-frame --seconds 5 --resolution 720p
```

`recommend` 是**确定性排序**(参数声明里有没有对应能力 + 预估价格升序),不是画质评测,
所以别替它编「画质更好」这类结论。用户选定后顺带问一句「以后默认用它吗?」,同意就
`config --default-video-model <名字>`——第二次对话就变成「直接说需求」。

### 付费调用前必须告知(脚本强制)

**视频任务不加 `--confirm` 永远不会提交**,脚本会先输出一张确认卡(模型 / 参数 / 费用 /
端点)。流程固定为:

1. 先运行不带 `--confirm` 的命令(脚本只出卡,不扣费):
   ```bash
   ... video --ref-image a.png --ref-image b.png --duration 10
   ```
2. 把卡片原样告诉用户,等用户明确回复「确认 / 生成吧」。
3. 用户确认后,才加 `--confirm` 重新执行**同一条命令**:
   ```bash
   ... video --ref-image a.png --ref-image b.png --duration 10 --confirm
   ```

`--confirm` 只认 10 分钟内、同一模型同一参数的预览记录:直接加 `--confirm` 会被拒绝,
换模型或改参数后也要重新出卡。这样用户至少会看到一次「模型 / 参数 / 费用」。

确认卡模板(脚本已生成,照抄即可):

```
需要用户确认(本次未提交)
  模型    wan3.0-video(内置默认)
  参数    10 秒|1080P|16:9|参考素材 3 个
  费用    无法精确预估(按 token 计费,按实际扣费为准)
```

禁止:

- **没等用户回复就自己加 `--confirm`**;用户只确认了模型/参数,就按那套执行,不许换。
- **10 分钟内重复提交**:脚本会拦截并列出最近的 task ID。先按 ID 查那条任务的状态;
  只有用户明确要再做一条时,才加 `--allow-multiple`(仍要先给确认卡)。
- **用换模型、改参数绕过拦截**——这仍然会产生新的真实扣费。
- 生图单张默认直接出图;`n>1` 或预估 > $0.10 时,先把脚本打印的「将调用 / 张数 / 预估」
  告诉用户并等确认再提交。

六条硬规则:

1. **用户点名模型就原样使用**,不许回退到他没指定的默认模型(模型名写错时如实报错)。
   「点名」指**用户在对话里明确说出的模型名**——不要把自己调研后选中的模型当成用户点名。
2. **用户没指定模型**:按上表解析。图片/视频永远有内置默认,不需要为此提问;文本模型
   没有内置默认,未配置时报错并列出候选,让用户选。**必须使用默认模型**:不得因为
   价格估不出来、厂商偏好或主观画质判断自行换成别的模型。默认模型确实缺少所需能力
   (如参考视频、首尾帧)时,先 `recommend` 给候选并让用户选,不能直接换。
3. **一次需求一次生成**:用户给素材 + 一句需求(例如「根据这 3 张产品图做一个 10 秒
   宣传视频」)时,把素材作为参考一次性传给默认视频模型,**一次提交完成**。不要自行
   拆分镜、先出关键帧再逐段生视频、多模型对比或后期剪辑——这些是额外付费操作,
   必须先向用户说明总预估并征得同意。
4. **参数不确定就先看 schema**,不要试探性调用、不要凭记忆写参数名。
5. **省略参数优于猜参数**:脚本只填 schema 里显式声明的默认值。**也不要把提示词里的
   形容词翻译成参数**——用户说「高清」「长一点」,只在确认卡里把可选值摆出来让他选,
   不要自动变成 1080P/10 秒。
6. **失败不等于可以重试**:视频任务报失败时,先用任务 ID 查一次状态、确认没有成片和
   扣费,再决定是否重试;脚本报的 `failed` 若无原因且计费仍是预扣,会自动继续确认。

### 参数引导(先判断要不要问,最多问 3 个)

**先判断这是不是「简单的一次性需求」,不是每次都要问。**

| 判断 | 典型说法 | 行为 |
|---|---|---|
| 简单、一次性 | 「画一只猫」「来个赛博朋克城市」「先看看效果」 | **直接生成**:默认模型 + schema 默认参数,0 个问题 |
| 有落地用途 / 要复用 | 「做公众号封面」「手机壁纸」「电商主图」「一套 3 张同风格」「多平台尺寸」 | 先问 **1~3 个**最关键参数,一轮问完 |

拿不准时**按简单处理、直接出图**:重生成/改图比先盘问更轻,用户不满意会继续说「竖版」「1080P」。
同一会话里的同类简单需求沿用同一套默认(模型、尺寸),不要每次随机换参数,保证输出口径一致。

需要提问时,按顺序取前 3 个,schema 里没有声明的跳过:

| 分类 | 优先问(按顺序) |
|---|---|
| 图片 | 画幅(竖屏 / 横屏 / 方图 → `aspect_ratio` 或 `size`)→ 质量(`quality`,若声明) |
| 视频 | 画幅(`aspect_ratio`)→ 时长(`duration`)→ 分辨率(`resolution`,直接影响价格) |

规则:

- **取值只从 `schema <模型>` 的 enum/range 里取**,不要自造 `2K`、`10秒` 这类不在定义里的值。
- **提示词里已经隐含的不要重复问**:用户说「竖版海报」「10 秒短片」就直接用,不再确认。
- **只问一轮**:问完就提交;用户回「随便 / 你定 / 默认」时全部按 schema 默认值发。
- **选项里带上成本提示**:视频的分辨率与时长会成倍改变价格,例如「720P(便宜)/ 1080P(约 2 倍)」;
  问完用 `--dry-run` 的 `estimate_usd` 给确认卡(见上)。
- **带参考图/首尾帧时少问**:用户已经给了素材,通常只确认时长或画幅,不追加无关问题。

例如:

- 「画一只猫」→ 直接生成,不问。
- 「给公众号文章配 3 张封面图」→ 问一轮:横版还是竖版、要不要统一风格 → 问完批量生成。

## 4. 首次使用:确认 key

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" quota
```

- 成功 → 直接干活
- 报「未配置 EasyAPI API Key」→ 按纪律代跑 `login --browser`,不要问用户要 key
- 报「账号下已有 N 个可用令牌,但没有名为 easyapi-skill 的专用令牌」→ 把令牌列表转述给
  用户让他选:复用(`--reuse-key 名字或ID`)还是新建(`--create-new`)。不要擅自新建或占用

`login` 自己也会先验证本地 key:能用就直接返回「无需重新授权」,不会再弹授权页。
只有换账号或明确要求重走授权时才加 `--force`。默认的 `login --browser` 走轮询取票:
授权页停在成功页不跳转,浏览器和脚本不必同机。要手动复制授权码用 `--manual`;
后端/网页版本过旧(取票 404 或页面提示参数错)才用 `--loopback` 走旧的本机回调。

**新建的 key 默认绑定本机设备指纹**(指纹每次运行时现算,绝不写进配置文件):即使配置被
拷到别的机器,key 也用不了。指纹变了会报 `client_binding_mismatch`:

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" login --browser --rebind
```

`--rebind` 会新建一个绑定本机的 key,并在落盘后吊销配置里的旧 key。想给 key 设上限:
`login --browser --key-quota 20 --key-expire-days 90`(不填则不限量、永不过期)。
复用已有令牌时不改绑定(它可能还在别的脚本/机器上用);要在多台机器用,就分别登录各建一个。

`models` / `schema` / `compare` / `recommend` 走匿名接口,**不需要 key**。

## 5. 配置完成后怎么回复用户

这是对话式 skill,配置成功后:

1. **不要给用户输出 CLI 命令让他去终端跑**——CLI 是你内部的实现细节。
2. **一两句话确认结果**:登录账号、令牌名、余额(有 `account_balance_usd` 就报账号余额;
   只有令牌视角就说「令牌不限量,消耗计入账号余额」)。
3. **给 2~3 个可以直接发的对话示例**:「帮我生成一只小猫,尺寸 1024x1024」
   「做一个猫在草地上跑的 5 秒视频」「EasyAPI 上有哪些生图模型,分别多少钱」。
4. 不贴 sk- key(哪怕打码)。

## 6. 生图

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" image --prompt "一只戴墨镜的柴犬,扁平插画风"
```

不写 `--model` 时用默认模型:用户配置过就用配置的,否则用内置的 `qwen-image-3.0-pro`。
要换模型就在对话里直接说(「用 seedream-4.5 画…」),或 `config --default-image-model <名字>`。

生图是**同步接口**,脚本默认最多等 **30 分钟**(`--timeout` 可调),慢模型和高峰期也不会被
2 分钟的超时打断。如果 agent 的单条命令有更短的超时上限,用后台运行(如 Bash 的
`run_in_background`)或把 shell 超时调大,**不要因为 shell 先超时就把任务判失败**。

```bash
... --prompt "改成水彩风格" --ref 参考图.png     # 图生图/改图(本地文件或 URL)
... --size 1024x1024 --quality high             # 用户明确要求时才指定
... --n 4                                        # 按次计费会按张数成倍扣费,先告知
```

**`--ref` 的投递方式由脚本按模型家族自动选**(seedream 走 JSON `image` 字段,
qwen-image / gpt-image 走 multipart `/v1/images/edits`),不要手工拼字段:

- **绝不要**手工往 `/v1/images/generations` 塞 `images` 数组——上游不认,部分渠道会静默
  返回一张没参考到参考图的文生图
- 输出里带 `ref_mode` / `endpoint`。用户反馈「没参考到」时用 `--ref-mode image|edits`
  换另一条路重试(详见 references/image.md)
- gemini 系图像模型不走 images 接口传参考图(脚本会明确报错)——需要图生图就换模型

## 7. 生视频

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" video --prompt "一只猫在草地上奔跑,电影感"
```

不写 `--model` 时用默认模型:用户配置过就用配置的,否则用内置的 `wan3.0-video`。
要换模型就在对话里直接说(「用 Kling-3.0 做…」),或 `config --default-video-model <名字>`。
**不要把自己挑中的模型写进 `--model`**——没点名就必须用默认模型。

用户给多张产品图时,**一次请求把图片全带上**,不要一张图生成一条视频,也不要先出
关键帧再逐段生成:

```bash
# 1) 预览:只出确认卡,不提交(wan3.0-video 支持 2-30 秒、多参考图)
... --ref-image 产品1.png --ref-image 产品2.png --ref-image 产品3.png --duration 10

# 2) 用户确认模型/参数/费用后,加 --confirm 提交同一条命令
... --ref-image 产品1.png --ref-image 产品2.png --ref-image 产品3.png --duration 10 --confirm
```

本地大图会转成 data URL 内嵌进请求体;3 张几 MB 的 PNG 很容易超过网关/上游的
请求体上限。先压到长边 1920 左右的 JPEG(每张 <1MB)再传。

脚本提交任务、轮询到完成、下载结果并打印路径;进度在 stderr,不污染结果。轮询总超时
默认 **900 秒**(`--timeout` 可调)。和生图一样,agent 的 shell 超时上限较小时用后台运行,
不要自己写轮询循环。提交端点由模型的端点声明解析(Kling、seedance 等各有路径),
解析不到回退 `/v1/videos`。

任务报失败时**不要立刻换模型重提**:脚本对「没有原因、计费仍在预扣」的 `failed` 会自动
继续确认;最终报错时先用任务 ID 查一次状态,确认没有成片和扣费再重试。
**10 分钟内已经提交过视频任务时,脚本会拒绝第二次提交并打印上次的 task ID**;
先查上一条,只有用户明确要再做一条时才加 `--allow-multiple`。

```bash
... --duration 10 --resolution 1080P              # 规格按 schema 的可选值,别自造
... --first-frame 首帧.png                        # 首帧驱动
... --first-frame 首帧.png --last-frame 尾帧.png    # 首尾帧(尾帧不能单独出现)
... --ref-image a.png --ref-image b.png           # 参考素材
```

视频多为**按秒计费**:10 秒 1080P 大约是 5 秒 720P 的 4 倍。用户要「长一点、清晰一点」时
先说清成本变化,或先跑 `compare` 看价格。

## 8. 把结果给用户看(预览优先)

生成成功后,**先让用户直接看到图/视频,再给文件路径**。按当前 agent 的能力选:

1. **对话里能渲染本地图片**:用 Markdown 图片语法内嵌绝对路径 `![画面描述](绝对路径)`,
   或使用该 agent 的图片/附件展示工具;有 Read/View 类工具时直接读这个文件,很多 UI 会回显。
   Windows 路径写成 `D:/...` 或 `file:///D:/...`,避免反斜杠被转义吃掉。
2. **对话里能播放视频**:用该 agent 的视频/附件语法把本地文件挂上来(有的用 `<video>`,
   有的用附件卡片)。不确定语法时退回到文件链接,别编一个不存在的标记。
3. **有内置预览面板**(如 ZCode 的预览窗口、Cursor 的图片预览、IDE 的 media viewer):
   主动在面板里打开生成的文件,再用一句话说明「已在预览面板打开」。
4. **以上都没有**(纯终端):给 Markdown 文件链接 + CDN URL;图片再附一次 URL,方便直接点开。
5. **本机桌面且用户就在旁边**:视频可以顺手用系统默认播放器打开(`start` / `open` /
   `xdg-open`),但不要阻塞等待播放器退出,也不要在远程/无桌面环境尝试。

`--json` 结果里图片在 `files[].path`、视频在 `path`;`download_error` 非空说明文件没落盘,
这时只能给 URL,并如实说明下载失败。

## 9. 查参数(不确定就查,别猜)

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" schema seedream-4.5
```

输出包含:分类、参数来源、**提交端点**、必填项、参数表(类型/必填/默认/枚举/范围)、
**一个可直接发送的示例请求体**。`--json` 给结构化字段(`params`、`required`、`example`、
`submit_endpoint`、`schema_sources`)。

参数来源按优先级,并且**逐字段合并**:

| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | `/pricing/schema?all=1` 全量包 | 一次拉全量,新模型上线自动生效;缓存 24h,`--refresh` 强刷 |
| 2 | `/pricing/schema?model_name=` 单模型 | 只有单模型接口的部署 |
| 3 | `/pricing/detail` 的 `params` | 更老的部署 |
| 4 | 内置 `references/model-snapshot.json` | 完全离线兜底 |

高优先级覆盖同名参数,低优先级补缺失参数。若输出提示「线上未声明 N 个参数,已用内置快照
补全」,说明这几个字段只有快照有定义:取值校验照做,但**未声明的动态字段可能被网关丢弃**,
报错时以 schema 里线上声明的字段为准。

> 注意:`env --network` 显示 `schema 接口不可用` 时,说明网关还没部署新接口,
> 会走 3/4 两级回退——功能不受影响,只是拿不到实时的新模型参数。

### 参数写错时的排查顺序

1. `schema <模型名>` 看正确参数名与取值
2. 厂商文档里的参数名(如 `aspectRatio`)不能直接用,网关用统一名(`aspect_ratio`)
3. 确认是厂商特有参数 → `--param key=value` 透传(值会按 JSON 解析)
4. 加 `--strict` 让「不在定义里」的参数直接报错,用来抓拼写错误

## 10. 模型选择

**不要自己猜模型名。** 先查:

```bash
"$EASYAPI_SKILL_DIR/bin/easyapi" models --category image
"$EASYAPI_SKILL_DIR/bin/easyapi" compare --category video --seconds 5
```

模型解析顺序:`--model` → 用户配置的默认 → 内置默认(图片 `qwen-image-3.0-pro`、
视频 `wan3.0-video`)→ 报错并列出候选(文本模型没有内置默认,未配置时走这一步)。

用户想换默认模型时,既可以在对话里点名(只影响这一次),也可以
`config --default-image-model <模型名>` / `config --default-video-model <模型名>` 持久修改;
传空字符串恢复内置默认。

模型选择明显影响价格或质量时(高清 vs 快速、时长),先给简短对比再让用户定。

## 11. 结果与错误

- **进度**在 stderr,**结果**在 stdout。`--json` 得到单个对象(`ok` / `files` / `path` /
  `model` / `model_source` / `task_id` / `endpoint` / `notes` / `warnings`)。
  `model_source` 是 `explicit` / `config` / `builtin`,用它判断要不要在回复里写「(默认)」——
  脚本的人类可读输出已经自动加了这个标注。
- **视频确认卡**:不带 `--confirm` 时返回 `needs_confirmation: true`、`submitted: false`、
  `estimate_usd`、`effective_params`、`recent_submissions`,退出码是 0(这不是错误)。
  把卡给用户看,确认后再加 `--confirm`。`estimate_usd` 为 null 时按 `estimate_reason`
  说明「按量计费,无法精确预估」。
- 生图结果也带 `estimate_usd` / `estimate_reason`;回复里可用来说明这次的大致花费。
- 失败时退出码非 0,`--json` 下有 `ok: false` + `error` + `hint`。**把 `hint` 转达给用户**,
  它通常就是解决办法。
- 视频超时不会丢任务:错误里带任务 ID 与查询地址,可稍后手工续查或加大 `--timeout`。
- 本地校验失败发生在发请求之前(`--dry-run` 同样会校验),所以参数错误不会白扣费。
- `client_binding_mismatch` = key 绑在另一台设备上(换机、改主机名、拷配置都会这样)。
  不要重试、不要换 key 乱试,直接告诉用户需要 `login --browser --rebind`。

## 12. 按需阅读

| 文件 | 什么时候读 |
|---|---|
| [references/image.md](references/image.md) | 生图参数细节、尺寸/质量/背景、参考图投递 |
| [references/video.md](references/video.md) | 生视频参数、首尾帧、轮询与计费细节 |
| [references/chat.md](references/chat.md) | 文本与多模态对话 |
| [references/models.md](references/models.md) | 计费方式与公式、比价陷阱 |
| [references/params-conventions.md](references/params-conventions.md) | 参数名对不上、首尾帧传了不生效 |
| [references/account.md](references/account.md) | key 配置、额度查询、只用 key 能做什么 |
| [references/troubleshooting.md](references/troubleshooting.md) | 报错时按状态码与原因查 |
| [references/fallback-curl.md](references/fallback-curl.md) | 没有 Python 时的降级配方 |

脚本入口:`bin/easyapi`(启动器)→ `scripts/easyapi.py`(仅标准库)。
Pliki w paczce (12)
  • SKILL.md 23 KB
  • bin/easyapi 2 KB
  • references/account.md 9 KB
  • references/chat.md 2 KB
  • references/fallback-curl.md 4 KB
  • references/image.md 8 KB
  • references/model-snapshot.json 106 KB
  • references/models.md 5 KB
  • references/params-conventions.md 5 KB
  • references/troubleshooting.md 6 KB
  • references/video.md 7 KB
  • scripts/easyapi.py 179 KB

Wersje

W bazie nie ma innych skilli o nazwie easyapi-studio.

Migawka bazy z 13.11.2026 · wersja paczki e146d494de86 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100easyapi-auth
    Konfiguruje konto EasyAPI i klucz API przez autoryzację w przeglądarce, sprawdza limit i pomaga naprawić brak klucza.
  • 98agnes-multimodal
    Generuje tekst, obrazy i wideo przez API Agnes AI, w tym tłumaczenie na angielski i odpytywanie wyników asynchronicznych.
  • 100bailian-gen
    Generuje i rozumie obrazy, wideo i mowę w Alibaba Cloud Bailian przez bl image, video, speech, vision i omni: tekst na obraz, edycja, wideo, TTS, transkrypcja i analiza obrazu.
  • 100writingmate-mcp
    Łączy się z serwerem MCP Writingmate, by porównywać odpowiedzi modeli AI oraz generować tekst, obrazy i wideo.
  • 100adflux-skills
    Generuje obrazy i wideo przez API adflux, z tekstu, obrazu referencyjnego albo klatek początkowej i końcowej, i sprawdza modele, koszty oraz wyniki.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.