Magnific API
Magnific API
Integrate Magnific's stock content library and AI-powered tools into your own applications.
The Magnific API lets developers integrate Magnific's content and AI capabilities directly into their own products, platforms, and workflows. Instead of using the Magnific website manually, you can programmatically search for stock assets, generate AI images and videos, edit content, and more through standard REST API calls.
The full technical reference (endpoints, parameters, authentication details, code examples, and response schemas) lives in the API documentation at docs.magnific.com. This article covers the essentials to help you understand what the API offers and how to get started.
In this article
What you can do with the API
The API is organized into several service areas:
Service | What it does |
|---|---|
Stock content | Search, filter, and download from over 200 million assets: vectors, photos, icons, PSD files, and more |
Generate images from text prompts using multiple AI models, including Mystic, Flux, and others | |
AI video generation | Create videos from text or image inputs using AI models |
Image editing | Remove backgrounds, upscale images with Magnific, apply filters, and perform other edits programmatically |
Icons | Search and download icons with format and style filters |
Audio | Generate sound effects and audio content via AI |
Available services and models may change as Magnific adds new AI capabilities. Check docs.magnific.com for the latest endpoint list.
Getting started
How to consume credits via API
Step 1 — Access the settings
Open the User menu and head into organization Settings. Inside, you'll find the API Keys section.
Step 2 — Create an API key
Create a new API key with an identifying name. The system will automatically generate:
The API key
The webhook signing secret
Both are shown only once. Make sure to copy them before closing the window.
Step 3 — Manage your keys
You can rename any key from the Actions menu without losing its secret or consumption history.
You can temporarily deactivate a key (useful for rotation or emergencies) without losing it.
You can permanently delete a key with explicit confirmation.
Step 4 — Audit credit usage
You can audit credit pool consumption by filtering by a specific API key for granular control over usage.
Enterprise accounts: if you don't see the API Keys section yet, contact your designated Magnific representative to request access. Once enabled, the steps above apply the same way.
API dashboard (legacy)
The API Dashboard is your central hub for managing everything related to your API usage. You can access it by clicking your profile picture in the top-right corner and selecting API Dashboard, or by going directly to magnific.com/developers/dashboard.
From the dashboard you can:
View and regenerate your API key
Track usage and monitor request volume in real time
Set a monthly budget to control spending
Review rate limits and pricing for each service
Manage billing information and payment methods
Credits based model API Administration Panel
Subscription-based API users can manage their accounts through the administration panel, which is located within the subscription panel. From here, you can perform the following actions:
Pricing and billing
The Magnific API uses a subscription system with a credit‑based model.
AI generation tools
Each API generation request — images, videos, audio, upscaling, editing, and more — deducts credits from your balance.
To use the API, you can choose from the following subscription plans:
Premium: 1 API key, 20K credits/month or 240K credits/year
Premium+: 1 API key, 45K credits/month or 600K credits/year
Pro: 3 API keys, 300K credits/month or 4M credits/year
Business: 5 API keys, 90K credits/month or 1.08M/year
Enterprise: unlimited API keys, custom yearly credits, scaling with your usage
You'll find detailed credit costs for each tool and generation in our Help Center.
All subscriptions also allow you to generate content directly on our website.
If your plan includes "Unlimited" usage, please note this applies only inside the Magnific web app — API calls always consume credits.
Stock content downloads
Premium, Premium+, and Pro plans: stock downloads via API don't consume credits but are limited to 100 per day.
Business and Enterprise plans: unlimited stock downloads, each deducted from your credit balance like any other API call.
Rate limits
The API enforces rate limits to ensure stability and fair usage for all developers. Limits apply at both the API key and IP address level.
Limit type | Threshold |
|---|---|
Per-second burst | 50 requests per second over a 5-second window |
Average rate | 10 requests per second averaged over a 2-minute window |
Daily limits | Vary by service. Check your dashboard for specific RPD (requests per day) and IPD (images per day) limits |
If you exceed these limits, requests may be throttled or temporarily blocked until the limit resets. If your application requires higher limits, contact the Sales team to discuss a custom plan.
Usage rules
The Magnific API is designed for integration into digital products and workflows. To keep your API access active, follow these rules:
Do not use the API for data mining, content scraping, or AI model training.
Do not sell or redistribute Magnific content without modification.
Report downloads accurately: trigger a download request every time a resource is uniquely used by a user. For example, when someone selects an image for a blog post, sets it as a header, or uses it as a background.
Caching is allowed as long as you maintain an active plan and report all downloads accurately and promptly.
Important
Breaching these rules will result in immediate API access removal.
Common error codes
When something goes wrong with a request, the API returns standard HTTP status codes. Here are the most common ones:
Code | Meaning | What to do |
|---|---|---|
401 Unauthorized | API key is invalid or missing | Check that your key is included in the x-magnific-api-key header and is correctly formatted |
404 Not Found | Endpoint or resource does not exist | Double-check the URL and request parameters |
429 Too Many Requests | Rate limit exceeded | Wait for the limit to reset, upgrade your plan, or contact Sales for higher limits |
500 Internal Server Error | Server-side issue | Retry the request. If it persists, contact support |
For the full list of response codes and their meanings, refer to the API documentation.
Resources and support
Resource | URL |
|---|---|
Full API documentation | docs.magnific.com |
API landing page | magnific.com/api |
API dashboard | magnific.com/developers/dashboard |
API Playground | magnific.com/api/playground |
API pricing | magnific.com/api/pricing |
Contact Sales | magnific.com/api#contact |
If you run into issues or have questions about your API integration, you can reach the support team through the contact form at magnific.com/api#contact or through the general support page.