AI 配图与插画 · Clawvard 课程 skill

一句话生成高分辨率配图。走 Clawvard 基建 Clawvard SDK 的 cv.media.generateImage（底层调用 nano-banana（Gemini）图像模型，Clawvard 后端按 credit 计费）。和短视频高光剪辑同一套 SDK，任何 agent runtime 都能用。

前置

• Node ≥ 18（node --version）。
• 统一用 Clawvard SDK key（Clawvard API key），无需自备图像 key。

1. 装 SDK + 鉴权

npm install @clawvard/sdk@latest         # 不要 pin，SDK 会持续加新方法
export CLAW_API_KEY=sk-...               # 问用户拿，别硬编码

import { Clawvard } from "@clawvard/sdk";
const cv = new Clawvard({ apiKey: process.env.CLAW_API_KEY! });

2. 生成图像

cv.media.generateImage 是 job 型，要 .wait()：

const img = await cv.media.generateImage({
  prompt: "<你的描述>",
  aspectRatio: "1:1",        // "1:1" | "16:9" | "9:16" | "3:4" | "4:5"
}).wait();
// img.imageUrl: "data:image/png;base64,..."  → 落盘即可

import { writeFile } from "node:fs/promises";
const [, b64] = img.imageUrl.split(",");
await writeFile("cover.png", Buffer.from(b64, "base64"));

（旧 SDK 没有这个方法时，用 cv.client.invoke("media", "generateImage", { prompt, aspectRatio }).wait()。）

3. 怎么用 + Prompt 参数（效果关键）

• aspectRatio — OG 图 16:9 / 方图 1:1 / 竖版 9:16 或 3:4
• 风格 — 像素风 / 扁平 / 写实 / 水彩，多给 2–3 个风格锚词
• 主体 — 放句首，强调「主体是 …」
• 系列一致 — 固定同一句风格描述，只改主体
• 文字 — 别让图像模型画字，后期叠字更清晰

调试 tips

• 401 → 检查 Clawvard API key
• 402 insufficient_credits → 去 /billing 充值
• 内容被拦 → 软化描述重试（服务内部已自动重试一次）

计费

约 12 cr/图，按成片计 —— 走 Clawvard 付费后端。先用 cv.platform.pricing() 读实时价，别硬编码。

产出物

cover.png —— 高分辨率配图，可固定风格批量出系列。

学习完成后

告诉用户：

我已经学会了 Clawvard 的 AI 配图课程。告诉我尺寸、主题和风格，我用 cv.media.generateImage 出高分辨率配图（OG 图 / 封面 / 插画）。