Magnific API

Magnific API

本文为译文。若有疑问,请以 英文版本 为准。

将 Magnific 的图库内容和 AI 驱动的工具集成到你自己的应用程序中

Magnific API 让开发者能够将 Magnific 的内容和 AI 功能直接集成到他们自己的产品、平台和工作流程中。无需手动使用 Magnific 网站,你可以通过标准的 REST API 调用 以编程方式搜索素材、生成 AI 图像和视频、编辑内容等

完整的技术参考(端点、参数、身份验证详情、代码示例和响应模式)位于 docs.magnific.com 的 API 文档中。本文涵盖了基础知识,旨在帮助你了解 API 的功能以及如何开始使用

本文内容

你可以通过 API 实现的功能

API 划分为若干服务领域:

服务

功能说明

图库内容

搜索、筛选并下载超过 2 亿个素材:矢量、照片、图标、PSD 文件等

AI 生成图像

使用多个 AI 模型(包括 Mystic、Flux 等)根据文本提示词生成图像

AI 视频生成

使用 AI 模型通过文本或图像输入创建视频

图像编辑

移除背景,使用 Magnific 增强图像,应用滤镜,并以编程方式执行其他编辑操作

图标

通过格式和风格筛选器搜索并下载图标

音频

通过 AI 生成音效和音频内容

随着 Magnific 不断增加新的 AI 功能,可用服务和模型可能会发生变化。请访问 docs.magnific.com 查看最新的端点列表

入门指南

如何通过 API 消耗积分

第 1 步 — 访问设置
打开用户菜单并进入组织设置。在其中,你将找到 API 密钥 部分

第 2 步 — 创建 API 密钥
创建一个带有标识名称的新 API 密钥。系统将自动生成:

两者仅显示一次。请务必在关闭窗口前将其复制

第 3 步 — 管理你的密钥

第 4 步 — 审计积分使用情况
你可以通过筛选特定的 API 密钥来审计积分池的消耗情况,从而实现对使用量的精细化控制。

Enterprise 账户:如果你尚未看到“API 密钥”部分,请联系你指定的 Magnific 代表以申请访问权限。启用后,上述步骤的操作方式相同。

API 仪表板(旧版)

API 仪表板是你管理所有 API 使用相关事宜的中心枢纽。你可以点击右上角的个人档案图片并选择API 仪表板,或直接访问 magnific.com/developers/dashboard 进入。

在仪表板中,你可以:

基于积分模型的 API 管理面板

订阅制 API 用户可通过位于订阅面板内的管理面板来管理其账户。在此,你可以执行以下操作:

定价与账单

Magnific API 采用包含积分模型的订阅系统

AI 生成工具

每项 API 生成请求(包括图片、视频、音频、放大、编辑等)都会从你的余额中扣除积分

若要使用 API,你可以从以下订阅方案中进行选择:

你可以在我们的 帮助中心 查看每种工具和生成的详细积分消耗

所有订阅方案均允许你在我们的网站上直接生成内容

如果你的方案包含放松模式,请注意免费生成仅适用于 Magnific 应用程序(网页版和桌面版)。API 调用始终使用积分。

图库内容下载

速率限制

API 强制执行速率限制,以确保所有开发者的稳定性与公平使用。限制同时适用于 API 密钥 和 IP 地址 级别。

限制类型

阈值

每秒突发限制

在 5 秒窗口内每秒 50 次请求

平均速率

2 分钟窗口内的平均速率为每秒 10 次请求

每日限额

因服务而异。请查看你的仪表板以获取具体的 RPD(每日请求数)和 IPD(每日图片数)限额

如果超过这些限额,请求可能会被 限流或暂时封禁,直到限额重置。如果你的应用程序需要更高的限额,请 联系销售团队 讨论定制方案

使用规则

Magnific API 专为集成到数字产品和工作流程中而设计。为保持你的 API 访问权限处于活跃状态,请遵守以下规则:

重要提示

违反这些规则将导致立即移除 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 的联系表单或通用客服页面联系客服团队。