Midjourney 视频 API 集成指南

xin35503
3 阅读3分钟

在当今的数字内容创作中，视频生成技术正在迅速发展。Midjourney 视频 API 允许开发者通过自定义参数生成高质量的视频。如果你想要在项目中集成此 API，本文将为你提供详细的指导。

背景介绍

Ace Data Cloud 是一个强大的数据处理和存储平台，提供多种 API 服务，包括视频生成。在众多应用场景中，Midjourney 视频 API 可用于自动生成动态内容，例如社交媒体视频、广告素材或个性化的教育内容等。

申请 API 服务

要使用 Midjourney 视频 API，你需要先在 Midjourney Videos API 页面申请相关服务。进入该页面后，点击“Acquire”按钮，如下图所示：

如果你尚未登录或注册，将自动跳转至登录页面。完成登录或注册后，页面会自动返回。

首次申请时，你将获得免费额度，可以免费使用该 API。

基本用法

在开始之前，了解基本的使用方法至关重要。你需要输入以下参数：

  • prompt: 视频生成的描述信息。
  • action: 操作类型，主要包括 generate（生成视频）和 extend（扩展视频）。
  • image_url: 生成视频首帧的参考图像链接。

请求头部示例：

accept: application/json
authorization: Bearer {token}

请求体示例：

{
  "image_url": "https://cdn.acedata.cloud/jgo1cw.jpg",
  "action": "generate",
  "prompt": "A cat sitting on a table",
  "mode": "fast",
  "resolution": "720p",
  "loop": false,
  "callback_url": "https://your.callback.url"
}

发送请求后，你将获得如下响应：

{
  "success": true,
  "task_id": "037955e0-deee-4050-baa8-1416300d67e2",
  "video_urls": [
    "https://storage.fonedis.cc//video/1c67c36c-8177-4f19-ad72-1dc1567265a6/0_0.mp4"
  ]
}

其中，video_urls 数组中包含了生成的视频链接。

扩展视频功能

如果你希望继续生成已经创建的视频，需要将 action 设置为 extend，并输入要扩展的视频 ID。视频 ID 可以根据基本用法获得。以下是请求体示例：

{
  "action": "extend",
  "video_id": "1751816807896311",
  "video_index": 0,
  "prompt": "A cat jumping off the table"
}

对应的 Python 示例代码如下：

import requests

url = "https://api.acedata.cloud/midjourney/videos"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}
payload = {
    "action": "extend",
    "prompt": "A cat jumping off the table",
    "video_id": "1751816807896311",
    "video_index": 0
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)

异步回调

由于生成视频的时间较长（约 1-2 分钟），为避免 HTTP 请求长时间占用资源，API 支持异步回调。你只需在请求中添加 callback_url 字段，生成后，结果将以 POST JSON 的形式发送到该 URL。

以下是如何设置 Webhook 的示例：

  1. 使用 Webhook.site 创建一个临时的 Webhook URL。
  2. 在 API 请求中设置 callback_url 为该 URL。

生成请求后，你将立即收到任务 ID，稍后可以在指定的 Webhook URL 查看生成结果。

错误处理

在调用 API 时，可能会遇到错误，API 将返回相应的错误代码和消息。例如：

  • 400 token_mismatched: 请求错误，可能是缺少或无效参数。
  • 401 invalid_token: 未授权，令牌无效或缺失。
  • 429 too_many_requests: 请求过多，超过了速率限制。

错误响应示例：

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  }
}

总结

通过本文，你已掌握如何使用 Midjourney 视频 API 生成视频。希望这能帮助你更好地集成和使用这一 API。如果有任何疑问，请随时联系技术支持团队。

技术标签：#Midjourney #视频生成 #API集成 #数据处理 #AceDataCloud

avatar
文章
阅读
粉丝