请参阅公开 URL 指南，了解过期行为、幂等性和端到端示例。

创建公开 URL

/v1/files/{file_id}/public-url

为现有文件创建一个无需身份验证的永久公开 URL。底层文件不受影响，仍可通过需要身份验证的内容端点获取。当你希望在需要 API 密钥的环境之外分享已存储的资源（图像、视频、PDF）时，可使用此功能。公开 URL 可随时通过 `POST /v1/files/{file_id}/public-url/revoke` 撤销。

路径参数

file_idstring

文件的 `id`。

请求体

响应体

public_urlstring

完整的公开 URL。

No parameters.

{
  "public_url": "https://files-cdn.x.ai/ZsqeMtdcSYWPPHTQdxXDKQ/file_a128090d-f0c9-4873-bd84-e499777e7417.png",
  "expires_at": 1755600000
}

撤销公开 URL

/v1/files/{file_id}/public-url/revoke

撤销文件当前有效的公开 URL。底层文件仍可通过需要身份验证的内容端点访问。撤销操作具有幂等性：对没有有效公开 URL 的文件调用时，会返回 `revoked: false`，不会报错。

路径参数

file_idstring

文件的 `id`。

响应体

idstring

公开 URL 被撤销的文件 ID。

revokedboolean

是否实际撤销了公开 URL。如果文件没有有效的公开 URL，则为 `false`（不执行任何变更）。

No parameters.

{
  "id": "file_a128090d-f0c9-4873-bd84-e499777e7417",
  "revoked": true,
  "public_url": "https://files-cdn.x.ai/ZsqeMtdcSYWPPHTQdxXDKQ/file_a128090d-f0c9-4873-bd84-e499777e7417.png"
}