Grok Imagine 在 RunAPI 上的使用

通过 RunAPI 使用 Grok Imagine 生成和编辑图像与视频。一次性代理任务的默认路径是 runapi CLI；SDK 则用于应用程序集成。

重要提示：集成运行时

• 集成类工作（如应用、后端、Worker、库、Rails 服务、Node 服务、Go 服务、Webhook 流水线或生产代码库）应使用目标语言对应的 SDK 集成路径。
• 一次性生成、编辑、转换、手动冒烟测试、调试，或用户发起的 CLI 运行，应使用带 runapi 二进制文件的 CLI 路径。有关 CLI 特定代理的完整指南，请参阅 https://github.com/runapi-ai/cli-skill。
• 切勿在生产环境的运行时集成层中通过 shell 调用 runapi CLI。

SDK 集成路径

将 Grok Imagine 集成至应用、后端、Worker、库、Rails 服务、Node 服务、Go 服务、Webhook 流水线或生产工作流时，请首先查阅当前 SDK 包及其官方用法说明。在参考 CLI 帮助或原始 HTTP 示例前，请务必确认安装命令、客户端方法（create、get、run）、请求字段、响应结构及错误类。请使用 RunAPI 提供的 SDK 包：

• JavaScript / TypeScript：@runapi.ai/grok-imagine
• Python：runapi-grok-imagine
• Ruby：runapi-grok-imagine
• Go：github.com/runapi-ai/grok-imagine-sdk/go
• Java：ai.runapi:runapi-grok-imagine
• PHP：runapi-ai/grok-imagine

CLI 路径

runapi 二进制文件是一次性任务和手动测试的运行时依赖项。有关 CLI 特定代理的完整指南，请参阅 https://github.com/runapi-ai/cli-skill。首次运行前请执行 runapi auth status。对于代理任务及无头运行（headless runs），建议直接设置环境变量 RUNAPI_API_KEY，或通过以下命令将其导入已保存的配置中：printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -。仅当用户明确要求交互式浏览器认证时，才使用 runapi login。

使用 CLI 帮助查看可用命令及请求字段：

runapi grok-imagine --help
runapi grok-imagine text-to-video --help

运行一次性任务（同步模式 —— 自动轮询直至任务完成）：

runapi grok-imagine text-to-video --input-file request.json

异步提交并单独轮询：

runapi grok-imagine text-to-video --async --input-file request.json
runapi wait  --service grok-imagine --action text-to-video

支持的命令包括：text-to-video、image-to-video、text-to-image、edit-image、extend、upscale-image。

生成文件的存储

RunAPI 生成的文件 URL 为临时链接。请在 7 天内将生成的图像、视频、音频或其他文件下载并存储至您自己的持久化存储中；不可将返回的 URL 视为长期资产。

参考资料

• 模型概览、定价与速率限制：https://runapi.ai/models/grok-imagine.md
• 完整模型目录：https://runapi.ai/models.md

变体类型

• Video 1.5 Fast
• Video 1.5 Preview
• Text to video
• Image to video
• Text to image
• Edit image