上传文件
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
- 文件会一直存储直到你手动删除