DragonAPI

切换主题

Grok Video 1.5 视频生成 ​

使用 DragonAPI 密钥和本站接口。示例中的 your-media.example 是占位地址，需替换为你自己的可访问素材或回调地址。协议、可用性与价格以当前模型说明和控制台为准。

使用 grok-video-1.5 从单张必填首图生成视频

  • 仅支持图生视频，不支持文生视频。
  • 必须且只能传入 1 张公网首图。
  • 视频时长支持 1–15 秒，默认 8 秒。
  • 支持 480p 和 720p。
  • 异步任务 API：提交后使用任务 ID 查询视频生成状态。

不要直接传入 base64 图片数据。请先将本地图片保存到可公开访问的 HTTPS 地址，再将该 URL 放入 image。

Authorizations ​

Authorization ​

string · 必填

所有接口均需要 Bearer Token 认证。

text
Authorization: Bearer YOUR_DRAGONAPI_KEY

Body ​

model ​

string · 必填 · 默认 grok-video-1.5

固定使用 grok-video-1.5。

prompt ​

string · 必填

描述参考图需要生成的动态效果、镜头运动和视觉方向。

image ​

string · 必填

必填首图 URL，且只能传入 1 张。仅支持公网可访问的 http:// 或 https:// 地址。

duration ​

integer · 可选 · 默认 8

视频时长。

支持范围：1–15 秒

resolution ​

string · 可选 · 默认 720p

视频分辨率。支持值：480p、720p。

aspect_ratio ​

string · 可选 · 默认 16:9

视频画面比例。支持值：1:1、16:9、9:16、3:2、2:3。

Response ​

id ​

string · 可选

用于查询任务状态的任务 ID。

object ​

string · 可选

对象类型，固定为 generation.task。

model ​

string · 可选

本次任务使用的模型名。

status ​

string · 可选

任务状态：queued、in_progress、completed 或 failed。

创建视频任务 ​

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-1.5",
    "prompt": "将这张产品图生成电影感商业视频，轻微镜头推进",
    "image": "https://your-media.example/product.jpg",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'
import requests

task = requests.post(
    "https://newapi.dragon3api.com/v1/videos",
    headers={
        "Authorization": "Bearer YOUR_DRAGONAPI_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "grok-video-1.5",
        "prompt": "将这张产品图生成电影感商业视频",
        "image": "https://your-media.example/product.jpg",
        "duration": 15,
        "aspect_ratio": "16:9",
    },
).json()

print(task["id"])
{
  "id": "video_abc123def456",
  "object": "generation.task",
  "model": "grok-video-1.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

查询任务状态 ​

使用返回的 id 调用 统一任务查询接口。

模型、价格与服务规则以当前控制台为准。

DragonAPI