/fal-ai/veo3/image-to-video

POST /fal-ai/veo3/image-to-video

MethodPOST
Path/fal-ai/veo3/image-to-video
Typehttp
Status1
Module2102810
Folder67000325

说明

概览

MethodPOST
Path/fal-ai/veo3/image-to-video
Typehttp
Status1
Module2102810
Folder67000325

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string",
        "description": "提示词"
      },
      "image_url": {
        "type": "string",
        "description": "参考图片URL"
      },
      "aspect_ratio": {
        "type": "string",
        "description": "尺寸,枚举值:16:9、9:16、auto,默认值: \"auto\""
      },
      "duration": {
        "type": "string",
        "description": "视频时长,默认值:\"8s\""
      },
      "generate_audio": {
        "type": "boolean",
        "description": "生成音频,默认值:true"
      },
      "resolution": {
        "type": "string",
        "description": "分辨率,枚举值:\"720p\"、\"1080p\""
      }
    },
    "required": [
      "prompt",
      "image_url"
    ],
    "x-apifox-orders": [
      "prompt",
      "image_url",
      "aspect_ratio",
      "duration",
      "generate_audio",
      "resolution"
    ]
  },
  "mediaType": "",
  "examples": [
    {
      "value": "{\r\n  \"prompt\": \"A woman looks into the camera, breathes in, then exclaims energetically, \\\"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\\\"\",\r\n  \"image_url\": \"https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png\",\r\n  \"aspect_ratio\": \"auto\",\r\n  \"duration\": \"8s\",\r\n  \"generate_audio\": true,\r\n  \"resolution\": \"720p\"\r\n}",
      "mediaType": "application/json",
      "description": ""
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 774143237,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string"
        },
        "request_id": {
          "type": "string"
        },
        "response_url": {
          "type": "string"
        },
        "status_url": {
          "type": "string"
        },
        "cancel_url": {
          "type": "string"
        },
        "logs": {
          "type": "null"
        },
        "metrics": {
          "type": "object",
          "properties": {}
        },
        "queue_position": {
          "type": "integer"
        }
      },
      "required": [
        "status",
        "request_id",
        "response_url",
        "status_url",
        "cancel_url",
        "logs",
        "metrics",
        "queue_position"
      ]
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]

响应示例

[
  {
    "name": "成功示例",
    "responseId": 774143237,
    "data": "{\r\n    \"status\": \"IN_QUEUE\",\r\n    \"request_id\": \"bcd3b436-b7af-42f3-8649-204657bfaf10\",\r\n    \"response_url\": \"https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10\",\r\n    \"status_url\": \"https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/status\",\r\n    \"cancel_url\": \"https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/cancel\",\r\n    \"logs\": null,\r\n    \"metrics\": {},\r\n    \"queue_position\": 0\r\n}",
    "description": "",
    "oasKey": "",
    "oasExtensions": "",
    "id": 708627088
  }
]