首页/文件与集合/管理文件

管理文件

上传、列出、删除和管理存储在 xAI 平台上的文件。

上传文件

Python
import os
from xai_sdk import Client

client = Client(api_key=os.getenv("XAI_API_KEY"))

# 上传文件
file = client.files.upload(
    file=open("document.pdf", "rb"),
    filename="document.pdf",
)

print(f"File ID: {file.id}")
print(f"File name: {file.filename}")
print(f"File size: {file.size} bytes")

列出和删除文件

Python
# 列出所有文件
files = client.files.list()

for f in files:
    print(f"{f.id} - {f.filename} ({f.size} bytes)")

# 删除文件
client.files.delete(file_id="file-abc123")

公共 URL

你可以为文件生成公共 URL,使其可以在 xAI 平台之外访问。 这对于分享文件或在 Web 应用中引用文件特别有用。

与文件对话

上传文件后,你可以在对话中引用文件让 Grok 分析其内容。 使用 attachment_search 工具让模型搜索文件附件内容。

存储费用

  • 文件存储:$0.025 / GiB / 天
  • 下载费用:按传输数据量计费
  • 文件附件搜索:$10 / 1K 次调用

文件限制

  • 单个文件最大大小取决于文件类型
  • 图像文件最大 20MiB,支持 JPG/JPEG 和 PNG
  • 文件会一直存储直到你手动删除