higgsfield/dop/image-to-video - 302.AI API Document

Request

Header Params

Body Params application/json

Example

{
  "image": "https://d1q70pf5vjeyhc.cloudfront.net/media/92ecf66930134a49a5a425b9def0c266/images/1760044568824748759_l861ZVRN.jpeg",
  "motions": [
    {
      "motion": "Zoom Out",
      "strength": 1
    }
  ],
  "options": "dop-preview",
  "prompt": "3D rotation"
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.302.ai/ws/api/v3/higgsfield/dop/image-to-video' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "image": "https://d1q70pf5vjeyhc.cloudfront.net/media/92ecf66930134a49a5a425b9def0c266/images/1760044568824748759_l861ZVRN.jpeg",
  "motions": [
    {
      "motion": "Zoom Out",
      "strength": 1
    }
  ],
  "options": "dop-preview",
  "prompt": "3D rotation"
}'

Responses

🟢200成功

application/json

Body

Example

{
    "type": "object",
    "properties": {
        "prompt": {
            "type": "string",
            "description": "用于生成视频的正向提示词（必填）。"
        },
        "images": {
            "type": "array",
            "minItems": 1,
            "maxItems": 3,
            "items": {
                "type": "string",
                "description": "参考图像的 URL 或 Base64 编码字符串。支持 PNG、JPEG、JPG、WebP 编码格式；图像尺寸至少为 128×128 像素；单张图像不超过 50MB；Base64 解码后的数据大小必须低于 50MB，并且必须包含适当的内容类型前缀。"
            },
            "description": "输入的参考图像列表（1~3 张，用于生成主体一致的视频，必填）。"
        },
        "resolution": {
            "type": "string",
            "enum": [
                "720p",
                "1080p"
            ],
            "default": "1080p",
            "description": "生成视频的分辨率（可选）。"
        },
        "generate_audio": {
            "type": "boolean",
            "default": true,
            "description": "是否生成音频（可选）。"
        },
        "negative_prompt": {
            "type": "string",
            "description": "用于生成视频的负向提示词（可选）。"
        },
        "seed": {
            "type": "integer",
            "minimum": -1,
            "maximum": 2147483647,
            "default": -1,
            "description": "用于生成的随机种子（范围：-1 ~ 2147483647，可选）。-1 表示使用随机种子。"
        },
        "callback": {
            "type": "string",
            "description": "回调接口地址（可选）。生成任务完成后系统会向此链接发送结果请求，返回状态码 200 表示接收成功。"
        }
    },
    "required": [
        "prompt",
        "images"
    ],
    "x-apifox-orders": [
        "prompt",
        "images",
        "resolution",
        "generate_audio",
        "negative_prompt",
        "seed",
        "callback"
    ]
}