视频

Grok Video

Grok Video API 支持 xAI 的文生视频和图生视频工作流，提供 480p/720p 分辨率输出、6-30 秒时长和风格控制。

文本或图片输入6-30 秒480p / 720p五种宽高比

正在加载工作区...

接口地址

POSThttps://api.apixo.ai/api/v1/generateTask/grok-video创建任务

GEThttps://api.apixo.ai/api/v1/statusTask/grok-video?taskId={taskId}轮询状态

身份验证

正在检查 API 访问权限...

登录以领取免费积分，测试演练场，并继续进行 API 集成。

请求体

request_type

async

通过 callback_url 使用回调以实现 Webhook。

input

对象

模式、提示词、参考图、尺寸、时长和音频设置。

参数

request_type必填

类型select

使用异步模式轮询任务状态 (poll statusTask)，或使用回调模式在结果就绪时接收 webhook 通知。async · callback

callback_url有条件的

类型text

用于接收回调通知的公开 HTTPS URL。仅限 request_type=callback

mode必填

类型select

选择此模型支持的视频工作流。text-to-video · image-to-video

prompt必填

类型string

描述最终视频的主体、动作、场景、镜头运动、光照和音频提示。

resolution必填

类型select

选择输出分辨率等级。480p · 720p

aspect_ratio必填

类型select

当所选模式支持时，选择输出宽高比。1:1 · 3:2 · 2:3 · 16:9 · 9:16

duration必填

类型slider

时长为 6 到 30 秒之间的整数。

style可选

类型select

动态风格预设。normal · fun · spicy

task_id有条件的

类型text

可选的已完成 grok-image 任务 ID，用于基于任务的图生视频。仅限 mode=image-to-video

index有条件的

类型text

与 task_id 一同使用时必填。支持的范围是 0 到 5。仅限 mode=image-to-video

参数	类型	必填项	描述
`request_type`	select	必填	使用异步模式轮询任务状态 (poll statusTask)，或使用回调模式在结果就绪时接收 webhook 通知。async · callback
`callback_url`	text	有条件的	用于接收回调通知的公开 HTTPS URL。仅限 request_type=callback
`mode`	select	必填	选择此模型支持的视频工作流。text-to-video · image-to-video
`prompt`	string	必填	描述最终视频的主体、动作、场景、镜头运动、光照和音频提示。
`resolution`	select	必填	选择输出分辨率等级。480p · 720p
`aspect_ratio`	select	必填	当所选模式支持时，选择输出宽高比。1:1 · 3:2 · 2:3 · 16:9 · 9:16
`duration`	slider	必填	时长为 6 到 30 秒之间的整数。
`style`	select	可选	动态风格预设。normal · fun · spicy
`task_id`	text	有条件的	可选的已完成 grok-image 任务 ID，用于基于任务的图生视频。仅限 mode=image-to-video
`index`	text	有条件的	与 task_id 一同使用时必填。支持的范围是 0 到 5。仅限 mode=image-to-video

文件参数 (URL 数组)

image_urls[mode=first_and_last_frames / omni_reference]first_and_last_frames 模式必填（1-2 张图）。omni_reference 模式选填（1-9 张图）。仅限 mode=first_and_last_frames / omni_reference

示例 (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/grok-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "text-to-video",
      "prompt": "a cinematic city street after rain, soft reflections, slow camera push",
      "duration": 6,
      "resolution": "480p",
      "aspect_ratio": "3:2",
      "style": "normal"
    }
  }'

完整 API 文档

Grok Video API 指南

用于视频生成工作流的 Grok Video API

通过 APIXO 使用 Grok Video，您可以在 Playground 中测试提示词、查看演示、比较价格，并将相同的设置直接应用于生产环境的 API 调用。

Grok Video 工作流

在一个页面内构建和部署 Grok Video API 工作流

此 Grok Video 模型主页专为希望在同一工作流中评估生成质量、比较价格、创建 API 密钥并将测试好的设置应用于生产代码的团队而设计。

Grok Video 提示词测试

在将请求投入生产前，使用 Grok Video Playground 测试提示词、模式选项和输出设置。

Grok Video 演示回顾

先检查真实的或占位的视频输出，然后将相同的演示参数加载到 Playground 中以加快迭代速度。

Grok Video API 对接

无需离开当前模型页面，即可从可视化测试无缝切换到 API 密钥、cURL 示例、请求 JSON 和相关文档。

Grok Video 定价清晰

在为生产任务选择成本模式前，请先在同一页面比较可用的定价方案。

Grok Video 输入控制

直接在 Playground 中调整图片、视频或运动参考，以确保测试的表单与文档化的 API 接口一致。

Grok Video 生产就绪

当异步轮询、回调交付、生成历史和可预测的计费对团队工作流至关重要时，请使用 APIXO。

模型概览

什么是 Grok Video API？

Grok Video 已通过 APIXO 作为生产级 API 提供，用于视频生成。该模型页面将 Playground 测试、真实请求参数、定价和文档对接整合在一个工作流中。

请先使用此页面验证提示词和模式选项，然后将相同的设置用于 API 密钥、cURL 示例、后端集成和可重复的生成任务。

面向生产团队的 Grok Video API 工作流

从 Playground 开始，选择与您的输入资产相匹配的模式。
当您需要快速获得基准配置时，可以查看输出示例并加载演示参数。
在发送大批量或更高分辨率的任务前，请检查价格。
对交互式应用使用异步轮询模式，对后端队列使用回调模式。

Grok Video API 技术规格

当前 Grok Video API 的功能及集成相关限制条件。

Grok Video 模式

文生视频与图生视频

Grok Video 输出

文本或图片输入

Grok Video 参数控制

6-30 秒 / 480p / 720p

Grok Video 延迟

通常需要 40-60 秒

xAI 视频 API

Grok Video 核心功能

Grok Video 视频生成

使用 Grok Video 进行文生视频与图生视频工作流，其 Playground 控件与公开的 API 文档保持一致。

Grok Video 参考控制

在可用时上传支持的参考素材，然后在生成的 API 示例中复用相同的设置。

Grok Video 异步交付

通过推荐的轮询和支持回调的生产集成，为长时间运行的生成任务做好规划。

您可以用 Grok Video 构建什么？

Grok Video 产品视频

使用可复用的 API 参数，创建产品发布、电商广告、发布短片和营销活动动态素材。

Grok Video 社交创意

为社交渠道生成短视频，并快速迭代提示词、时长、分辨率和宽高比等设置。

Grok Video 故事板工作流

在投入生产预算前，使用文本提示词和参考来验证场景、镜头和动态创意。

Grok Video 注意事项与限制

时长必须为 6-30 秒。
提示词长度必须为 1-5000 个字符。
图生视频支持一个直接的图片 URL，或来自 grok-image 任务的 task_id 及索引。
支持的风格值为 normal、fun 和 spicy。
基于任务续写所支持的结果索引范围是 0 到 5。

Grok Video 常见问题

开始构建

先在上方 Playground 进行测试，准备好集成时再查阅 API 文档。

尝试 Playground 查看 API 文档