logo
RunComfy
  • ComfyUI
  • 训练器新
  • 模型
  • API
  • 定价
discord logo
模型
探索
所有模型
资源库
生成记录
模型 API
API 文档
API 密钥
账户
使用情况

Wan 2.1 文本生成视频:帧数与 FPS 设置 | RunComfy

wan-ai/wan-2-1/text-to-video

根据文本生成视频,并设置分辨率、宽高比、帧数、帧率、随机种子等选项。

目录

1. 快速开始2. 身份验证3. API 参考提交请求查询请求状态获取请求结果取消请求4. 文件输入托管文件(URL)5. 数据结构输入结构输出结构

1. 快速开始

使用 RunComfy 的 API 运行 wan-ai/wan-2-1/text-to-video。 可接受的输入与输出请参阅模型的 数据结构说明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/wan-ai/wan-2-1/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A haunting title sequence with distressed, flickering typewriter-style text forming the words 'THEY ARE WATCHING' on a textured, grainy black background. The letters jitter as they appear, as if typed by an unseen force. Ink stains and scratches flash momentarily before fading away. The eerie, flickering glow of an old fluorescent bulb casts shadows across the scene. The sound of faint typewriter clicks and distant whispers adds to the unsettling atmosphere, evoking a sense of mystery and unease."
  }'

2. 身份验证

将 YOUR_API_TOKEN 环境变量设置为您的 API 密钥(在 个人资料中管理密钥),并在每个请求的 Authorization 标头中以 Bearer 令牌形式携带: Authorization: Bearer $YOUR_API_TOKEN。

3. API 参考

提交请求

提交异步生成任务,将立即获得 request_id 以及用于查询状态、获取结果和取消的 URL。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/wan-ai/wan-2-1/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A haunting title sequence with distressed, flickering typewriter-style text forming the words 'THEY ARE WATCHING' on a textured, grainy black background. The letters jitter as they appear, as if typed by an unseen force. Ink stains and scratches flash momentarily before fading away. The eerie, flickering glow of an old fluorescent bulb casts shadows across the scene. The sound of faint typewriter clicks and distant whispers adds to the unsettling atmosphere, evoking a sense of mystery and unease."
  }'

查询请求状态

根据 request_id 获取当前状态("in_queue"、"in_progress"、"completed" 或 "cancelled")。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

获取请求结果

获取指定 request_id 的最终输出与元数据;若任务未完成,响应会返回当前状态,便于继续轮询。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

取消请求

通过 request_id 取消排队中的任务;进行中的任务无法取消。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 文件输入

托管文件(URL)

请提供可公网访问的 HTTPS 地址。确保目标主机允许服务端拉取(无需登录或 Cookie)、未被限流或拦截爬虫。建议:图片 ≤ 50 MB(约 4K),视频 ≤ 100 MB(约 720p 下 2–5 分钟)。私有资源请使用稳定或预签名 URL。

5. 数据结构

输入结构

{
  "type": "object",
  "title": "输入结构",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "提示词",
      "description": "必填,用于描述需要生成的视频场景。",
      "type": "string",
      "default": "A haunting title sequence with distressed, flickering typewriter-style text forming the words 'THEY ARE WATCHING' on a textured, grainy black background. The letters jitter as they appear, as if typed by an unseen force. Ink stains and scratches flash momentarily before fading away. The eerie, flickering glow of an old fluorescent bulb casts shadows across the scene. The sound of faint typewriter clicks and distant whispers adds to the unsettling atmosphere, evoking a sense of mystery and unease."
    },
    "resolution": {
      "title": "分辨率",
      "description": "可选 `480p`、`580p` 或 `720p`,默认为 `720p`。",
      "type": "string",
      "enum": [
        "480p",
        "580p",
        "720p"
      ],
      "default": "720p"
    },
    "aspect_ratio": {
      "title": "宽高比(宽:高)",
      "description": "可选 `16:9` 或 `9:16`,默认为 `16:9`。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16"
      ],
      "default": "16:9"
    },
    "num_frames": {
      "title": "帧数",
      "description": "可选 `81`、`85`、`89`、`93` 或 `97`,默认为 `81`。",
      "type": "integer",
      "enum": [
        81,
        85,
        89,
        93,
        97
      ],
      "default": 81
    },
    "frames_per_second": {
      "title": "帧率",
      "description": "可设为 5–24 FPS,默认值为 16 FPS。",
      "type": "integer",
      "maximum": 24,
      "minimum": 5,
      "default": 16
    },
    "enable_prompt_expansion": {
      "title": "提示词扩写",
      "description": "开启或关闭提示词扩写,默认开启。",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "随机种子",
      "description": "整数随机种子,默认值为 `29733570`。",
      "type": "integer",
      "default": 29733570
    },
    "num_inference_steps": {
      "title": "推理步数",
      "description": "以整数指定推理步数。",
      "type": "integer"
    },
    "enable_safety_checker": {
      "title": "安全检查",
      "description": "开启或关闭安全检查。",
      "type": "boolean"
    }
  }
}

输出结构

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "单张图片 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "单个视频 URL"
      },
      "images": {
        "type": "array",
        "description": "多张图片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "多个视频 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
关注我们
  • 领英
  • Facebook
  • Instagram
  • Twitter
支持
  • Discord
  • 电子邮件
  • 系统状态
  • 附属
视频模型
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • 查看所有模型 →
图像模型
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • 查看所有模型 →
法律
  • 服务条款
  • 隐私政策
  • Cookie 政策
RunComfy
版权 2026 RunComfy. 保留所有权利。

RunComfy 是首选的 ComfyUI 平台,提供 ComfyUI 在线 环境和服务,以及 ComfyUI 工作流 具有惊艳的视觉效果。 RunComfy还提供 AI Models, 帮助艺术家利用最新的AI工具创作出令人惊叹的艺术作品。