文件 API
公开 URL
请参阅公开 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"
}