apimodels.app

Grok Video API(xAI)

xAI 出品的高质量视频生成模型,动作自然流畅。走 apimodels.app 的统一视频端点:一次 POST 创建任务,再轮询同一个端点取结果,和 VEO、Kling、Seedance 的调用方式完全一样,换模型只改 model 字段。两个公开模型名:grok-video-3 按秒计价,480p / 720p $0.04/秒、1080p $0.12/秒,可出 6 / 10 / 15 秒;grok-video-3-10s 按条一口价,720p $0.30 / $0.50 / $0.70、1080p $0.35 / $0.65 / $2.00 对应 6 / 10 / 15 秒。两者都支持图生视频。

模型与价格

模型	model	时长	价格	说明
Grok Video 3	grok-video-3	6 / 10 / 15 秒	$0.24-$0.60	图生视频,$0.04/秒(1080p $0.12/秒)
Grok Video 3(10 秒)	grok-video-3-10s	6 / 10 / 15 秒	$0.30-$2.00	图生视频,按条一口价:720p $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00

两个名字对应同一个模型,区别只在计价方式:grok-video-3 按秒计价(480p / 720p $0.04/秒,1080p $0.12/秒),grok-video-3-10s 按分辨率 × 时长六档一口价(默认 10 秒)。两者都能出 1080p,出片质量一致,按哪个便宜选就行:**要 1080p 的 6 秒或 10 秒,用 grok-video-3-10s**($0.35 / $0.65,按秒版是 $0.72 / $1.20);**要 1080p 的 15 秒,用 grok-video-3**($1.80,一口价版是 $2.00)。480p 只有 grok-video-3 有,720p 也是按秒版更便宜。

创建任务

POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。

# Step 1: Create task
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "A cat playing piano in a jazz club, cinematic lighting",
    "aspect_ratio": "16:9"
  }'

# Step 2: Poll status
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

字段	必填	类型	说明
model	是	string	grok-video-3 / grok-video-3-10s
prompt	是	string	视频内容描述文本
aspect_ratio	否	string	"16:9"(默认)、"1:1"、"9:16"、"2:3"、"3:2"
duration	否	number	6、10、15(grok-video-3 默认 6,grok-video-3-10s 默认 10)
size	否	string	grok-video-3:"480P"、"720P"(默认);grok-video-3-10s:"720P"(默认)、"1080P"
images	否	string[]	参考图 URL 数组,最多 7 张 —— 传了就是图生视频。也接受 image_urls / image 两种写法。
callback_url	否	string	任务完成后的回调 URL

取回结果

创建接口立即返回 data.taskId,视频在后台生成。带上这个 task_id 向同一个端点发 GET,读 data.state:pending 表示还在跑,completed 时 data.resultUrls[0] 就是视频地址,failed 时 data.failMsg 是原因。不想轮询就传 callback_url,任务结束后我们主动 POST 通知你。

实测出片耗时:6 秒片约 60-85 秒;15 秒片带多张参考图和长提示词可到 4 分钟。客户端超时建议留到 6 分钟以上,或者直接用 callback_url 免轮询。
结果视频保存 30 天后自动删除,请及时下载或转存。
调用成功后扣费,失败不扣费。

使用要点

支持 16:9、9:16、1:1 等宽高比,横屏、竖屏、方图一个端点全覆盖——社媒素材不用换模型。
grok-video-3 按秒计价,单价看分辨率:480p 与 720p 同为 $0.04/秒(6 秒 $0.24、10 秒 $0.40、15 秒 $0.60),1080p 为 $0.12/秒(6 秒 $0.72、10 秒 $1.20、15 秒 $1.80)。要 1080p 的短片(6 / 10 秒),grok-video-3-10s 的一口价更便宜。
图生视频:在 images 里放参考图 URL(最多 7 张),模型会照着它们的人物、场景和风格生成,不传就是纯文生视频。
grok-video-3-10s 按条一口价:720p 6 / 10 / 15 秒 $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00,适合成本要能预先算清的批量生成。
鉴权与其它模型一致:Header 带 Authorization: Bearer YOUR_API_KEY,同一把 key 可调平台上所有视频、图片、语音和 LLM 模型。

常见问题

Grok 视频生成有 API 吗?

有。在 apimodels.app 向 /api/v1/video/generations 发 POST,传 model "grok-video-3"(或 "grok-video-3-10s")、prompt,以及可选的 aspect_ratio,然后拿返回的 task_id 轮询同一个端点,直到 data.state 变成 "completed",data.resultUrls[0] 就是视频地址。这套请求格式和站内的 VEO、Kling、Seedance 完全一致,换模型只改 model 一个字段,一把 key 全都能调。

Grok Video 3 一条视频多少钱?

grok-video-3 按秒计价:480p / 720p $0.04/秒(6 秒 $0.24、10 秒 $0.40、15 秒 $0.60),1080p $0.12/秒($0.72 / $1.20 / $1.80)。另一个模型名 grok-video-3-10s 按条一口价:720p 6 / 10 / 15 秒 $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00。失败不扣费,只有成功才计费。

grok-video-3 和 grok-video-3-10s 有什么区别?

同一个模型,区别只在计价方式,两者都能出真 1080p。grok-video-3 可出 6 / 10 / 15 秒,按秒计:480p / 720p $0.04/秒(合 $0.24-$0.60),1080p $0.12/秒(合 $0.72-$1.80);grok-video-3-10s 按分辨率 × 时长六档按条一口价:720p 6 / 10 / 15 秒 $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00(默认 10 秒),批量生成时成本能提前算清。按形态选:1080p 的 6 秒或 10 秒选 grok-video-3-10s 更低($0.35 / $0.65,按秒版是 $0.72 / $1.20);1080p 15 秒以及 480p、720p 选 grok-video-3 更低。

Grok Video 3 支持图生视频吗?

支持。grok-video-3 和 grok-video-3-10s 都既能纯文生视频,也能图生视频,走的是同一个 /api/v1/video/generations 端点。想先看效果,可以直接在模型页 apimodels.app/models/grok-video-3 和 /models/grok-video-3-10s 上传图跑一次。

Grok Video 3 支持哪些宽高比?生成要多久?

aspect_ratio 支持 "16:9"(默认)、"1:1"、"9:16"、"2:3"、"3:2",横屏、竖屏、方图一个端点全覆盖,做社媒素材不用换模型。10 秒的片子一般约 60 秒出结果,更短的约 30 秒,建议 5-10 秒轮询一次;不想轮询就传 callback_url,任务结束我们主动 POST 通知。

Grok Video 生成的视频链接能存多久?

结果视频保留 30 天后自动删除,需要长期保存请及时下载或转存。data.state 变成 "completed" 后,视频地址在 data.resultUrls[0];任务失败时 data.failMsg 是原因,且不扣费。