API 参考

直接上传小文件（建议 < 4MB），文件数据通过 gRPC 消息体传输。大文件请使用预签名上传流程。

对已缓存 object_key 的资产，重新生成预签名访问 URL（原 URL 已过期或即将过期时使用）。

验证平台账号凭证是否有效，可在正式绑定或发布前检查凭证可用性。

直接把 Markdown 或 HTML 内容发布到微信公众号——一站式完成正文预处理、封面上传、创建或更新草稿，并可选触发群发；适合 CLI 工具直接调用的场景。

列出当前用户的所有自定义预设。

列出所有系统排版模板。

获取指定模板的排版提示词。提示词描述了该模板的排版规则，可直接用于 LLM 指令。

用户在同意页授权后生成授权码。

查询 token 的有效性与元数据（RFC 7662）。

返回当前活跃的 ID Token 签名公钥列表（JWKS 格式，RFC 7517 §5）。用于 OIDC 双 token 模型中 id_token (JWT, RS256) 的本地验签。

吊销访问 token 或刷新 token（RFC 7009）。

用授权码、刷新 token 或客户端凭证换取 token 对。

列出所有可用的 scope，可按 category 过滤。

按名称查询单个 scope。

GetProfileRequest 是空消息——调用方身份完全由 OAuth access token 决定。URL 里的 `me` 是保留字，含义为"当前 token 持有者"；用 `/v1/users/{user_id}` 替代会被拒绝为 403 PERMISSION_DENIED。

List one level of direct child categories.

Revoke a confirmed subtree and its pages, then schedule exact cleanup.

Produce a signed exact impact snapshot for one category subtree.

Apply one unexpired settled preview without a second charge.

Create a durable estimate for one natural-language organization request.

Consume an estimate and accept asynchronous organization planning.

Return one user-requested category organization job.

Return the durable settled preview produced by a successful job.

Return the user-scoped singleton category preference.

Fully replace or explicitly clear the singleton category preference.

Atomically freeze the user input and create a page plus generation job. Vertex owns LLM charging and quota admission; this request deliberately carries no quote, balance, budget, or user-authorized charge fields.

Return the authoritative state of one generation job.

Read current state and immutable history without triggering recovery.

Consume a RETRY_JOB estimate and create a new job with frozen input.

Create a durable, short-lived estimate without starting generation. Deprecated. New clients call CreateGeneration directly.

Consume a CREATE_PAGE estimate and atomically create a page and job. Deprecated. New clients call CreateGeneration directly.

List the user's recent pages or pages directly assigned to one category.

Return one authoritative page without embedding version HTML.

Revoke page access and accept its exact content scope for cleanup.

Read private requirements for an owned page; never includes system prompts.

Read private requirements for an owned page; never includes system prompts.

List immutable published-version summaries for one page.

Return one complete immutable version, including validated HTML.

Refresh the controlled download ticket for a published artifact.

Return authoritative published-version metadata without HTML or download tickets.

Make one immutable historical version current without creating a job.

Produce a signed, short-lived exact deletion-impact snapshot.

Consume a REGENERATE_PAGE estimate and create a new logical job.

Save a user display name without regenerating immutable artifacts.

Return one user-owned material's validation and parsing fact.

Revoke access to one unbound material and schedule cleanup.

Return the user's authoritative hosted-content protection state.

Consume one estimate item and create a durable multipart session.

Return and reconcile one durable multipart session.

Abort an unfinished multipart session without creating a material.

Complete and verify multipart content, then create a material on success.

Sign short-lived PUT capabilities for explicitly requested parts.

Create a durable file-service estimate before reserving or signing work.