视频生成 API:免费 AI 视频 / 图片生成接口

用两行请求把文字变成视频:提交任务 → 轮询状态 → 取回视频。免费、不用显卡、对开发者友好。

Agnes 开放 API(Base URL 是 https://apihub.agnes-ai.com),给免费视频和图片模型提供编程接口。典型用法是:先 POST 建一个任务,然后轮询状态直到完成,最后从返回的 video_url 下载成片。全程 Bearer 认证,限速每分钟 16 次,撞上 429 会自动指数退避重试。

API 端点

MethodEndpoint描述
POST/v1/videos创建视频生成任务。Body:model(agnes-video-v2.0)、prompt、width/height、num_frames、frame_rate。返回任务 ID。
GET/agnesapi按 video_id 轮询视频任务状态,返回 status(pending/completed/failed)、progress 与完成后的 video_url。
POST/v1/images/generations创建图片生成任务,model 用 agnes-image-2.1-flash,附带 prompt 与 size。
GET/v1/models列出当前可用的文本、图片、视频模型及其 model_id。

API 特性

完全免费且无需显卡:模型都在云端运行,用你的 Key 即可调用

文本 / 图片 / 视频统一入口,一个 Key 通吃

异步任务 + 短轮询(约 30 秒一次,最长 15 分钟)

提示词支持中文等多语言,直接用自然语言描述画面

分辨率、帧数、时长可选,输出 720p(横屏 1152×768、竖屏 768×1152、方形 1024×1024)

限速 16 次 / 分钟,自带 429 指数退避

快速开始示例

# 步骤 1 — 提交视频任务
import requests, time

API_KEY = "your_api_key"   # 在 platform.agnes-ai.com 免费获取
BASE = "https://apihub.agnes-ai.com"

headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.post(f"{BASE}/v1/videos", headers=headers, json={
    "model": "agnes-video-v2.0",
    "prompt": "一只白狐漫步在薄雾中的竹林",
    "width": 1152, "height": 768,   # 16:9
    "num_frames": 121,               # 约 5 秒 @24fps
    "frame_rate": 24,
})
resp.raise_for_status()
video_id = resp.json().get("video_id") or resp.json().get("task_id")

# 步骤二 — 轮询状态直到完成
while True:
    r = requests.get(f"{BASE}/agnesapi", headers=headers,
                     params={"video_id": video_id}).json()
    if r["status"] == "completed":
        print("视频地址:", r["video_url"]); break
    if r["status"] == "failed":
        raise RuntimeError(r.get("error", "生成失败"))
    time.sleep(30)

Agnes API 让每个开发者都能免费接入真实可用的视频生成能力。拿到 Key 即可从 4 个端点起步:先看 GET /v1/models 确认当前模型 ID,再 POST /v1/videos 提交任务,最后轮询取回成片。配合限速与错误处理即可快速跑通。

相关页面

免费获取 Agnes AI API Key 教程 — 3 分钟配置 | 免费 AI 视频指南

Agnes AI API Key 完全免费获取:注册账号、创建密钥、复制的完整步骤,以及 Web UI / 环境变量 / API 三种配置方式,附 401 报错排查与常见问题解答,3 分钟即可完成配置开始生成。

Agnes Video Generator 自托管部署教程 — 手动/Docker/npm/AI Agent | 免费 AI 视频

把免费开源的 AI 视频生成器跑在自己的电脑或服务器上:start.sh 手动部署、Docker 一条命令、npm CLI、AI Agent 辅助共四种方式,含完整命令、系统要求与环境变量说明,轻松自托管。

常见问题 — AI 视频生成器问答 | Agnes Video

关于 Agnes Video Generator 的常见问题合集:怎么用 Agnes AI 免费视频模型、是不是真的不需要高性能显卡、支持哪些视频模式和最长时长、API Key 怎么免费拿、免费额度和使用限制,以及和付费工具的区别,一次讲清。

简易视频示例提示词 — 文生视频 Prompt 范例 | 免费 AI 视频

简易图像视频模式的现成提示词示例:湖边黄昏、美食特写、霓虹夜景等 3 个可直接复制的 Prompt,每个都附完整参数设置与画质优化建议,并逐条讲解怎么写更稳定、效果更好;复制粘贴即可生成一支风格统一的短视频,无需任何提示词经验,新手十分钟就能上手,非常适合快速入门文生视频创作。模型参数与风格关键词都替你选好了。

接口契约与规范

本文档的端点、鉴权与参数说明以 Agnes AI 开放 API 为准,并参考主流平台 API 规范。

  1. Agnes AI Open API — 视频 / 图片生成接口Agnes AI · apihub.agnes-ai.com (2026)

    所有端点的请求/响应契约(/v1/videos、状态轮询等)以 Agnes 开放 API 文档为准。

  2. OpenAI API Reference — REST 接口规范OpenAI · OpenAI Docs (2025)

    Bearer 鉴权、REST 风格等 API 设计惯例参考了 OpenAI API Reference 等行业标准。

  3. Artificial Intelligence Index Report 2025Stanford HAI · Stanford AI Index 2025 (2025)

    Stanford AI Index 2025 记录了 AI API 经济的爆发式增长,验证了 API 文档标准化是行业发展的关键基础设施。

  4. The Economic Potential of Generative AI: The Next Powerhouse of Productivity and Growth?McKinsey & Company · McKinsey Global Institute (2023)

    McKinsey 报告估算了 API 驱动的 AI 服务在企业集成中的经济价值,为开发者选择 API 接入模式提供商业合理性依据。

内容可信度说明

本文由一线实践者撰写,写的时候交叉核对了 arXiv 论文、厂商技术报告和 Stanford AI Index 等一手来源,不是凭主观印象下的结论。

S

SandGrid@lcy362

Agnes Video Generator 项目作者 · 全栈开发者

独立开发者,开源 AI 视频生成工具 Agnes Video Generator 的作者。项目基于 Agnes AI 完全免费的视频模型,MIT 协议开源,已经帮 1,000+ 创作者零成本产出过 AI 视频。长期关注视频生成模型的工程化和普及,文章内容都来自一线实践和一手研究。

访问 GitHub

最后更新2026-08-21

准备好开始创作了吗?

「让世界级的 AI 属于每一个人。」—— Bruce Yang。完全免费,不用信用卡,也不要高性能显卡,零成本做出你的第一支 AI 视频。想用 Agnes AI 的免费视频模型?从这里开始就行。

克隆 GitHub 仓库,两分钟即可启动