图像转视频

图像转视频端点通过根据文本提示生成高质量的视频动画，使静态图像栩栩如生。

模型名称: image-to-video

生命周期: experimental

处理时间: 约60秒–180秒

输出格式: MP4

交付方式: URL (通过状态轮询)

积分: 每个视频6到12个 (取决于时长)

请求

通过将您的图像和提示提交到通用 /v1/run 端点来生成视频：

POSThttps://fititon.app/api/v1/run

请求示例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

响应

由于视频生成需要几分钟，/v1/run 端点会立即返回 200 OK 状态以及一个异步作业 id。您必须使用 GET /v1/status/{id} 轮询状态 API 以检索最终的 MP4 URL。或者，您可以配置 Webhook 以自动接收通知。请注意，我们的 Webhook 调度程序强制执行严格的 15 秒超时。您的服务器必须在 15 秒内以 2xx 状态码确认 Webhook，否则我们将认为它失败并稍后重试。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

请求参数

必填参数

imageUrlRequiredstring

要制作动画的输入图像。可以是公开可访问的 URL 或 Base64 编码的图像字符串。

专业提示： 包含可见头发、织物或树叶的图像会产生最自然的运动。静态平铺或仅产品照片的动画效果不佳 — 请使用包含人物或场景的图像。避免过度裁剪的图像，以便为 AI 提供移动空间。

格式要求 提交 Base64 字符串时，必须包含标准数据 URI 前缀（例如，data:image/jpeg;base64,...）。

可选参数

promptstring

指导动画的文本描述。如果省略，AI 将从图像上下文中推断自然运动。

durationinteger

生成视频的时长（秒）。支持的值：4、6、8。 默认值: 6

aspectRatio'16:9' | '9:16'

输出视频的宽高比。 默认值: 9:16

generateAudioboolean

是否生成上下文 AI 音频以伴随视频。 默认值: true

运行时错误

此功能的运行时错误使用错误处理中记录的共享集。如果在处理过程中发生错误，status 将更新为 "error"，并且 error 字段将包含具体的失败原因。

积分成本

对于开发者 API 请求，成本完全取决于请求的视频 duration。

公式： 成本 = 时长积分

时长	每个视频的积分
4s	6
6s (默认)	9
8s	12