快速开始
总览
把 Imagifly 的图片与视频生成能力接入你的应用、脚本和 Agent。
Imagifly 是一个 AI 图片与视频生成平台。所有模型共用一个积分钱包：把提示词、参考图或首帧变成电影感静帧和短视频，结果就存在你在应用里用的那个作品库。
本站是这套平台的接入指南。你可以通过 HTTP 直接调用，也可以把它通过 MCP 接到 Agent 上，让 Agent 替你调用。
你可以构建什么
图片生成
文生图，可带参考图，支持画面比例、质量档位和推理步数。
视频生成
覆盖各视频模型的文生视频、参考图生视频以及首帧/尾帧工作流。
Agent 工作流
一个 MCP 服务器，把同一套生成工具开放给 Claude Code、Codex、OpenClaw、WorkBuddy 和 Cursor。
工作原理
- 在 API 控制台 创建 API Key，并像保管密码一样保管它。
- 通过 HTTP 发送生成请求，或者把 MCP 服务器加到你的 Agent 里，让它调用这些工具。
- 请求会立即返回一个任务 ID；轮询这个 ID，直到任务结束。
- 从完成的任务里读取输出 URL，然后下载文件。
异步是设计的一部分
生成是异步的。返回 202 只说明任务已被接受、积分已被预扣，并不意味着图片或视频已经生成。请持续查询任务，直到 status 变为 success 或 failed。
从这里开始
API 通用约定
创建 Key、发出第一个请求，并了解所有接口共同遵循的规则。
接入 Agent
在 Claude Code、Codex、OpenClaw、WorkBuddy 或 Cursor 中安装 Imagifly MCP 服务器。
错误
状态码、错误标识，以及哪些失败会自动退回积分。
API 覆盖范围
- 生成 —— 提交任务、轮询状态、读取输出 URL。
- 模型 —— 实时模型目录，包含每个模型的积分价格、支持的尺寸、画面比例和参考图上限。
- 账号 —— API Key 标识账号；每个任务都会计入该账号的积分。
没有用于列出、删除或取消任务的接口，也没有 Webhook 或回调。等待结果唯一受支持的方式是轮询。