API 參考

直接上傳小文件（建議 < 4MB），文件數據通過 gRPC 消息體傳輸。大文件請使用預簽名上傳流程。

對已緩存 object_key 的資產，重新生成預簽名訪問 URL（原 URL 已過期或即將過期時使用）。

驗證平臺賬號憑證是否有效，可在正式綁定或發佈前檢查憑證可用性。

直接把 Markdown 內容發佈到微信公眾號——一站式完成 Markdown 渲染、封面上傳、創建或更新草稿，並可選觸發群發；適合 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.