curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-video-1.5",
"input": {
"prompt": "A cinematic city at sunrise",
"resolution": "1080p",
"duration": 6,
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"message": "<string>",
"data": {
"task_id": "<string>",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Grok (xAI)
Grok Imagine Video 1.5
Grok Imagine Video 1.5 API 可根据文本或一张首帧图片生成最高 1080p 的 1–15 秒视频，或根据最多七张参考图片生成最高 720p 的视频。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-video-1.5",
"input": {
"prompt": "A cinematic city at sunrise",
"resolution": "1080p",
"duration": 6,
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"message": "<string>",
"data": {
"task_id": "<string>",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
grok-imagine-video-1.5 可通过三种生成模式输出 1–15 秒的视频：
- 文生视频：不传两个图片字段。支持 480p、720p 和 1080p。
- 图生视频：在
image_urls中提供恰好一项作为首帧。支持 480p、720p 和 1080p。 - 参考生视频：在
reference_image_urls中提供 1–7 项。在提示词中以<IMAGE_0>、<IMAGE_1>等方式引用它们。支持 480p 和 720p。
image_urls 和 reference_image_urls 不能同时使用。
模型
- grok-imagine-video-1.5 — Grok Imagine Video 1.5
必填参数
- prompt（必填）：最多 4,096 个字符。
可选参数
- image_urls：图生视频所用的首帧图片，恰好一张。
- reference_image_urls：1–7 张参考图片，用于保持角色、主体或风格一致。
- resolution：
480p、720p或1080p。参考生视频不支持1080p。默认：720p。 - duration：
1到15的整数。默认：文本/图片模式为6，参考模式为8。 - aspect_ratio：
16:9、4:3、3:2、1:1、2:3、3:4或9:16。仅适用于文本模式和参考模式；默认：16:9。 - callback_url：可选的完成通知 Webhook URL。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes