只读 API

用 API Key 通过 HTTP 检索 Genvizu 提示语库、拼装 Skill 提示语。

最近更新: 2026-09-24

Genvizu 只读 API(v1)让你的脚本和智能体可以检索提示语库、读取单条提示语详情、浏览公开的 Skills 目录,并按参数拼装 Skill 提示语。它是只读的:不会生成图片或视频,也不会消耗积分。API 访问包含在 Pro 与 Ultimate 套餐中。

机器可读的接口规范见 /openapi.json(OpenAPI 3.1)。

快速开始

在 Pro 或 Ultimate 套餐下进入 设置 → API 密钥,创建一把密钥(每个账号最多 5 把)。密钥以 sk_ 开头,只显示一次,请妥善保存。
每次请求都以 Bearer 令牌方式携带。

curl -H "Authorization: Bearer sk_your_key" \
  "https://genvizu.com/api/v1/prompts/search?q=cyberpunk%20city&pageSize=10"

Node.js(18 及以上自带 fetch):

const res = await fetch(
  'https://genvizu.com/api/v1/prompts/search?q=product%20photo&model=gpt-image-2',
  { headers: { Authorization: `Bearer ${process.env.GENVIZU_API_KEY}` } }
);
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
for (const item of body.data) {
  console.log(item.title, item.prompt, item.attribution.page_url);
}

端点

方法	路径	作用
GET	`/api/v1/prompts/search`	检索提示语。参数:`q`、`category`、`model`、`mediaType`、`tag`、`sort`(`latest` / `hot` / `random`,缺省为精选序)、`page`(1–10)、`pageSize`(1–20,缺省 20)、`locale`(`en` / `zh`)。分页越界返回 400。列表项只含 `thumbnail_url`。
GET	`/api/v1/prompts/{id}`	单条提示语:全部分段、完整 `media_urls` 与出处。
GET	`/api/v1/skills`	已发布的 Skills:名称、描述、参数、输入要求、默认值、封面。
POST	`/api/v1/skills/{id}/compose`	按 Skill 参数拼装一条可直接使用的提示语。不生成任何内容,不消耗积分。
GET	`/api/v1/me`	积分余额、套餐与今日 API 配额。本端点不计入配额。

compose 请求体(字段均可选):

{ "prompt": "a matte black water bottle", "params": { "scene": "studio" }, "strength": "mid" }

响应格式

成功响应为 { "data": ..., "meta": ... },计入配额的请求还会在 meta.quota 里返回 limit、used、remaining;失败响应为 { "error": { "code": "...", "message": "..." } }。所有响应都不缓存(Cache-Control: private, no-store)。

提示语文本与网站同一套可见规则。返回全文,但单独付费解锁的作品除外:这类作品只返回前 120 个字符,并标记 prompt_locked: true。每条数据都带 attribution(作者、原帖链接、平台与 Genvizu 页面)。媒体只以公开地址返回:检索结果只带缩略图,详情接口才带完整媒体列表。

每日配额

配额按账号计算,同一账号的所有密钥共享,每天 UTC 0 点重置。同一把密钥两次请求之间至少间隔 1 秒。

套餐	每日请求数
免费、积分包、Starter	无 API 权限
Pro	1,000
Ultimate	3,000

计入配额的请求会在响应头返回 X-RateLimit-Limit 与 X-RateLimit-Remaining。

错误码

HTTP	code	含义
400	`invalid_params`	请求体或参数格式错误,或输入未通过内容规范。
401	`unauthorized`	缺少密钥、格式错误、已删除或不存在。
403	`plan_required`	当前套餐没有 API 权限,请升级到 Pro 或 Ultimate。
403	`forbidden`	账号已封禁、邮箱未验证,或该 Skill 需要更高套餐。
404	`not_found`	提示语或 Skill 不存在或未公开。
429	`rate_limited`	当日配额已用完或请求过快。请按 `Retry-After` 秒数等待。
503	`unavailable`	API 暂时关闭,请稍后再试。

数据条款

API 数据仅供检索与参考,不包含训练或微调模型的授权。展示提示语时请保留出处。我们可能调整配额,并封禁滥用 API 的密钥。详见服务条款。

即将推出:MCP server

我们正在开发 MCP server,把同样的只读能力提供给 Claude、Cursor 等 MCP 客户端。