Grok Imagine 1.5 视频生成

本接口使用异步模式：先创建任务，再查询状态；完成后从任务结果中的原始下载地址获取视频。支持文生视频和图生视频。

接入前必读

创建和查询任务必须携带 1788 API Key：Authorization: Bearer YOUR_1788_API_KEY。完成后返回的 url 是可直接访问的原始下载地址，无需额外请求头。
若下游也是 New API，请将渠道类型设为 Sora，不要选 OpenAI，以正确处理异步创建与轮询流程。
下载 URL 由视频渠道提供，可能是带时效参数的地址；请原样使用，不要自行拼接、替换或删除参数。
duration 是 JSON 数字，不能加双引号：写 "duration": 6，不要写 "duration": "6"。

1. 创建视频任务

POST https://1788.love/v1/videos

string

必填

Bearer YOUR_1788_API_KEY

string

必填

application/json

string

默认值:"grok-imagine-1.5-video"

必填

固定填写 1788 对外模型名：grok-imagine-1.5-video。

string

必填

视频内容描述，支持中文和英文。

string

默认值:"16:9"

画幅比例。可用：16:9、9:16、1:1、3:2、2:3。

integer

默认值:6

视频时长，单位为秒，范围为 6–30。必须传 JSON 数字，例如 6；不要加引号。

string

默认值:"720p"

清晰度：480p 或 720p。推荐使用 quality。

string

quality 的兼容别名。若同时传入两个字段，优先使用 quality。

string[]

可选的参考图 URL 列表，用于图生视频。最多 7 张；必须是公网可访问的 HTTP(S) 图片 URL；不支持 base64。参考图会影响最终画幅比例。

curl --request POST \
  --url https://1788.love/v1/videos \
  --header 'Authorization: Bearer YOUR_1788_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.5-video",
    "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

import requests

response = requests.post(
    "https://1788.love/v1/videos",
    headers={
        "Authorization": "Bearer YOUR_1788_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "grok-imagine-1.5-video",
        "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
        "size": "16:9",
        "duration": 6,  # int，不是 "6"
        "quality": "720p",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://1788.love/v1/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_1788_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-1.5-video",
    prompt: "一只狗在海滩上奔跑，阳光明媚，慢镜头",
    size: "16:9",
    duration: 6, // number，不是字符串 "6"
    quality: "720p",
  }),
});

console.log(await response.json());

图生视频示例

先调用上传图片，再把返回的 url 原样放入 image_urls：

{
  "model": "grok-imagine-1.5-video",
  "prompt": "让画面动起来，添加自然的动态效果",
  "image_urls": ["https://tu.baoliu.love/uploaded/example-image.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}

创建成功响应

{
  "id": "task_example123456789",
  "object": "video.generation",
  "model": "grok-imagine-1.5-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1785564000
}

保存 id，用于后续查询。

2. 查询任务状态

GET https://1788.love/v1/videos/{id} 建议每 3–5 秒查询一次。状态含义：

状态	含义	下一步
`queued`	已入队，等待处理	继续查询
`processing`	正在生成	继续查询
`completed`	已完成	从 `data.result.videos[0].url` 下载
`failed`	生成失败	查看 `error`，不要再下载

curl --request GET \
  --url https://1788.love/v1/videos/task_example123456789 \
  --header 'Authorization: Bearer YOUR_1788_API_KEY'

response = requests.get(
    "https://1788.love/v1/videos/task_example123456789",
    headers={"Authorization": "Bearer YOUR_1788_API_KEY"},
)
response.raise_for_status()
print(response.json())

已完成响应

{
  "id": "task_example123456789",
  "object": "video.generation",
  "model": "grok-imagine-1.5-video",
  "status": "completed",
  "progress": 100,
  "created_at": 1785564000,
  "data": {
    "result": {
      "videos": [
        {
          "url": "https://download.example.com/videos/result.mp4?token=EXAMPLE_TEMPORARY_TOKEN"
        }
      ]
    }
  }
}

url 是渠道返回的原始下载地址，可直接在浏览器、下载器或 <video> 中使用，不需要 1788 API Key。部分渠道会在 URL 中附带临时访问参数；请完整保留这些参数，并尽快下载或保存视频。

3. 下载视频内容

使用查询响应中 data.result.videos[0].url 的完整地址下载。下载地址返回视频二进制内容。直接使用上一步返回的完整 URL；不要将返回内容按 JSON 解析。

cURL

curl --location \
  --url 'https://download.example.com/videos/result.mp4?token=EXAMPLE_TEMPORARY_TOKEN' \
  --output result.mp4

JavaScript

const response = await fetch(
  "https://download.example.com/videos/result.mp4?token=EXAMPLE_TEMPORARY_TOKEN",
);

if (!response.ok) throw new Error(`Download failed: ${response.status}`);
const videoBlob = await response.blob();
const localURL = URL.createObjectURL(videoBlob);
// 将 localURL 设置为 <video src>，或创建 <a download> 下载。

常见错误

现象	常见原因	处理方式
创建请求参数错误	`duration` 写成字符串，或画幅/清晰度不合法	`duration` 使用数字；检查 `size`、`quality`
查询正常、下载 401/403/404	原始下载 URL 已过期、参数被修改，或渠道临时不可用	使用查询响应返回的完整 `url`；不要删改 URL 参数；必要时重新查询任务
下游 New API 无法下载	下游渠道类型选为 `OpenAI`	删除该渠道并改用 `Sora` 类型，Base URL 填 `https://1788.love`
图生视频失败	图片不是公网 URL、为 base64、或图片数量超过 7	先上传图片，使用返回 URL；最多 7 张
一直 `queued` 或 `processing`	上游仍在生成	间隔 3–5 秒继续查询，勿高频轮询

开始使用

API 参考

渠道对接

Grok Imagine 1.5 视频生成

接入前必读

1. 创建视频任务

图生视频示例

创建成功响应

2. 查询任务状态

已完成响应

3. 下载视频内容

常见错误

​接入前必读

​1. 创建视频任务

​图生视频示例

​创建成功响应

​2. 查询任务状态

​已完成响应

​3. 下载视频内容

​常见错误

接入前必读

1. 创建视频任务

图生视频示例

创建成功响应

2. 查询任务状态

已完成响应

3. 下载视频内容

常见错误