Magnific API
Magnific API
本文为译文。若有疑问,请以 英文版本 为准。
将 Magnific 的图库内容和 AI 驱动的工具集成到你自己的应用程序中
Magnific API 让开发者能够将 Magnific 的内容和 AI 功能直接集成到他们自己的产品、平台和工作流程中。无需手动使用 Magnific 网站,你可以通过标准的 REST API 调用 以编程方式搜索素材、生成 AI 图像和视频、编辑内容等
完整的技术参考(端点、参数、身份验证详情、代码示例和响应模式)位于 docs.magnific.com 的 API 文档中。本文涵盖了基础知识,旨在帮助你了解 API 的功能以及如何开始使用
本文内容
你可以通过 API 实现的功能
API 划分为若干服务领域:
服务 | 功能说明 |
|---|---|
图库内容 | 搜索、筛选并下载超过 2 亿个素材:矢量、照片、图标、PSD 文件等 |
使用多个 AI 模型(包括 Mystic、Flux 等)根据文本提示词生成图像 | |
AI 视频生成 | 使用 AI 模型通过文本或图像输入创建视频 |
图像编辑 | |
图标 | 通过格式和风格筛选器搜索并下载图标 |
音频 | 通过 AI 生成音效和音频内容 |
随着 Magnific 不断增加新的 AI 功能,可用服务和模型可能会发生变化。请访问 docs.magnific.com 查看最新的端点列表
入门指南
如何通过 API 消耗积分
第 1 步 — 访问设置
打开用户菜单并进入组织设置。在其中,你将找到 API 密钥 部分
第 2 步 — 创建 API 密钥
创建一个带有标识名称的新 API 密钥。系统将自动生成:
API 密钥
Webhook 签名密钥
两者仅显示一次。请务必在关闭窗口前将其复制
第 3 步 — 管理你的密钥
你可以从“操作”菜单中重命名任何密钥,且不会丢失其密钥内容或消耗记录。
你可以暂时停用某个密钥(适用于轮换或紧急情况),且不会将其删除。
你可以通过确认操作永久删除某个密钥。
第 4 步 — 审计积分使用情况
你可以通过筛选特定的 API 密钥来审计积分池的消耗情况,从而实现对使用量的精细化控制。
Enterprise 账户:如果你尚未看到“API 密钥”部分,请联系你指定的 Magnific 代表以申请访问权限。启用后,上述步骤的操作方式相同。
API 仪表板(旧版)
API 仪表板是你管理所有 API 使用相关事宜的中心枢纽。你可以点击右上角的个人档案图片并选择API 仪表板,或直接访问 magnific.com/developers/dashboard 进入。
在仪表板中,你可以:
查看并重新生成你的 API 密钥
追踪使用情况并实时监控请求量
设置月度预算以控制支出
查看速率限制及各项服务的定价
管理账单信息和支付方式
基于积分模型的 API 管理面板
订阅制 API 用户可通过位于订阅面板内的管理面板来管理其账户。在此,你可以执行以下操作:
定价与账单
Magnific API 采用包含积分模型的订阅系统
AI 生成工具
每项 API 生成请求(包括图片、视频、音频、放大、编辑等)都会从你的余额中扣除积分
若要使用 API,你可以从以下订阅方案中进行选择:
Premium:1 个 API 密钥,20000 积分/月或 240000 积分/年
Plus:1 个 API 密钥,45000 积分/月或 600000 积分/年
Pro:3 个 API 密钥,300000 积分/月或 4000000 积分/年
Business:5 个 API 密钥,90000 积分/月或 1080000 积分/年
Enterprise:无限 API 密钥,自定义年度积分,随使用量扩展
你可以在我们的 帮助中心 查看每种工具和生成的详细积分消耗
所有订阅方案均允许你在我们的网站上直接生成内容
如果你的方案包含放松模式,请注意免费生成仅适用于 Magnific 应用程序(网页版和桌面版)。API 调用始终使用积分。
图库内容下载
Premium、Plus 和 Pro 方案:通过 API 进行的图库下载不消耗积分,但限制为每天 100 次。
Business 和 Enterprise 方案:图库下载不限次数,但每次下载都会像其他 API 调用一样从你的积分余额中扣除。
速率限制
API 强制执行速率限制,以确保所有开发者的稳定性与公平使用。限制同时适用于 API 密钥 和 IP 地址 级别。
限制类型 | 阈值 |
|---|---|
每秒突发限制 | 在 5 秒窗口内每秒 50 次请求 |
平均速率 | 2 分钟窗口内的平均速率为每秒 10 次请求 |
每日限额 | 因服务而异。请查看你的仪表板以获取具体的 RPD(每日请求数)和 IPD(每日图片数)限额 |
如果超过这些限额,请求可能会被 限流或暂时封禁,直到限额重置。如果你的应用程序需要更高的限额,请 联系销售团队 讨论定制方案
使用规则
Magnific API 专为集成到数字产品和工作流程中而设计。为保持你的 API 访问权限处于活跃状态,请遵守以下规则:
禁止 将 API 用于数据挖掘、内容抓取或 AI 模型训练
禁止 在未经修改的情况下出售或重新分发 Magnific 内容
准确报告下载量: 每当用户唯一性地使用资源时,请触发一次下载请求。例如,当有人为博客文章选择一张图片、将其设置为页眉或将其用作背景时
允许缓存,前提是你保持有效的方案,并准确、及时地报告所有下载。
重要提示
违反这些规则将导致立即移除 API 访问权限。
常见错误代码
当请求出现问题时,API 会返回标准的 HTTP 状态代码。以下是最常见的代码:
代码 | 含义 | 处理建议 |
|---|---|---|
401 未授权 | API 密钥无效或缺失 | 请检查你的密钥是否包含在 x-magnific-api-key 请求头中,并确保格式正确 |
404 未找到 | 端点或资源不存在 | 请仔细检查 URL 和请求参数 |
429 请求过多 | 已超出速率限制 | 请等待限制重置、升级你的方案,或联系销售部门以获取更高的限制 |
500 内部服务器错误 | 服务器端问题 | 请重试请求。如果问题仍然存在,请联系客服 |
有关响应代码及其含义的完整列表,请参阅 API 文档
资源与客服
资源 | URL |
|---|---|
完整 API 文档 | docs.magnific.com |
API 落地页 | magnific.com/api |
API 仪表板 | magnific.com/developers/dashboard |
API 试验场 | magnific.com/api/playground |
API 定价 | magnific.com/api/pricing |
联系销售 | magnific.com/api#contact |
如果你在 API 集成过程中遇到问题或有任何疑问,可以通过 magnific.com/api#contact 的联系表单或通用客服页面联系客服团队。