Grok官方API配置
本文介绍如何在 DFCine 中接入 xAI Grok 官方视频生成 API，并完成账号注册、额度开通、API Key 配置、网络设置和常见错误排查。
适用范围
DFCine 当前的“Grok视频官方”工作流使用 xAI 官方接口：
- 官方控制台：https://console.x.ai/
- 官方视频模型页：https://docs.x.ai/developers/models/grok-imagine-video
- 官方视频生成说明：https://docs.x.ai/developers/model-capabilities/video/generation
DFCine 中只需要填写 xAI API Key。
第一步：注册 xAI 控制台账号
打开 xAI 控制台，按页面提示登录或注册账号。进入控制台后，创建或选择一个 Team，并确认当前 Team 可以使用 API 服务。
如果页面无法打开，或 DFCine 请求时提示网络不可用，请先查看本文后面的“中国用户网络设置”。
第二步：充值或开通额度
Grok 官方视频生成需要 xAI Team 有可用 credits 或 licenses。
- 在 xAI 控制台进入当前 Team。
- 打开 Billing、Credits、Usage 或类似的账单/额度页面。
- 按页面提示购买 credits 或开通可用 license。
- 充值完成后，回到控制台确认余额或额度已经生效。
如果 DFCine 返回类似下面的错误，说明网络和 API Key 已经连通，但账号没有额度：
HTTP 403 permission-denied
Your newly created team doesn't have any credits or licenses yet.这种情况不是 DFCine 配置错误，需要在 xAI 控制台完成充值或开通。
第三步：创建 API Key
- 在 xAI 控制台打开 API Keys 页面。
- 创建新的 API Key。
- 复制生成的 API Key。
- 妥善保存，不要把 API Key 发给他人。
API Key 通常只在创建时完整显示一次。如果忘记或泄露，建议删除旧 Key 后重新创建。
第四步：在 DFCine 中填写 API Key
- 打开 DFCine。
- 进入“设置”。
- 找到 API 设置区域。
- 在“x AI”区域填写刚才复制的 API Key。
- 保存设置。
第五步：使用 Grok 视频官方工作流
- 在画布中创建视频节点。
- 在工作流列表中选择 API 分类。
- 选择“Grok视频官方”。
- 根据需要选择生成模式：
- 文生视频：只输入提示词，不需要连接图片。
- 图生视频：连接一张图片，使用提示词驱动图片生成视频。
- 多图参考视频：连接多张图片，按图像输入顺序作为参考。
- 设置比例、分辨率和时长。
- 点击运行。
如果要先测试账号是否可用，建议先用“文生视频”跑一个短时长任务。文生视频不上传图片，更容易判断账号、额度和网络是否正常。
当前视频生成价格
中国用户网络设置
xAI 的官网和 API 服务在部分中国大陆网络环境下可能无法直接稳定访问。即使浏览器可以打开 x.ai，DFCine 也可能因为没有走同一条代理链路而请求失败。
推荐使用支持 TUN 模式的代理或 VPN 工具。开启 TUN 后，DFCine、Electron、Node 等非浏览器程序的网络请求也会被代理接管。
建议设置：
- 开启代理或 VPN。
- 开启 TUN 模式。
- 如果工具提供“系统代理”，也可以同时开启。
- 路由规则中确保
api.x.ai走代理节点。
常见判断方式：
- 返回
401、403或400：通常说明已经连到 xAI，问题在 Key、权限、额度或请求参数。 - 返回
fetch failed、连接超时、无法连接服务器：通常是网络、代理、TUN 或上传链路问题。 - 访问
https://api.x.ai/v1返回404：这是正常的，因为/v1根路径不是业务接口；能返回 404 反而说明网络已连通。
可以在 Windows PowerShell 中测试：
curl.exe -I https://api.x.ai/v1如果直连失败，但你的代理端口是 127.0.0.1:10808，也可以测试：
curl.exe -x http://127.0.0.1:10808 -I https://api.x.ai/v1返回 HTTP/1.1 404 Not Found 属于正常连通结果。真正需要关注的是连接超时、无法连接或 DNS 失败。
常见错误说明
HTTP 403 permission-denied
通常表示账号或 Team 没有 credits 或 licenses。请到 xAI 控制台充值或开通。
HTTP 401 unauthenticated
通常表示 API Key 没有填写、填写错误、已失效，或复制时多了空格。请重新复制 API Key 并保存。
fetch failed
通常表示当前网络无法连接 xAI API，或图生视频上传图片时请求体较大导致代理链路中断。
处理建议：
- 开启 TUN 模式。
- 换稳定的代理节点。
- 先用文生视频测试。
- 图生视频时尽量使用体积较小的 JPG/PNG 图片。
/v1 返回 404
这是正常现象。https://api.x.ai/v1 是 API 版本根路径，不是具体业务接口。DFCine 实际视频生成接口会请求 /v1/videos/generations。
安全提醒
- 不要把 xAI API Key 发给他人。
- 不要在截图、日志、视频教程中露出完整 API Key。
- 如果怀疑 API Key 泄露，请立即在 xAI 控制台删除旧 Key 并创建新 Key。
- 生成视频会消耗 xAI credits，请在控制台关注余额和使用记录。