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
- Getting started
- API dashboard
- Pricing and billing
- Rate limits
- Usage rules
- Common error codes
- Resources and support
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 |
| AI image generation | 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 |
Getting started
How to consume credits via API in a Business plan
Step 1 — Access the settings
Open the User menu and head into organization Settings. Inside, you'll find the new API Keys section.
Step 2 — Verify your plan
Only Business and Enterprise plans can generate credentials to consume credits via API. The documentation is available at docs.magnific.com, accessible only to these plans.
Step 3 — 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
Step 4 — 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 5 — Plan limits
- Business: up to 5 active API keys. When trying to create a sixth, a conversion point to Enterprise is surfaced.
- Enterprise: unlimited keys, with a direct path to sales.
Step 6 — Audit credit usage
You can audit credit pool consumption by filtering by a specific API key for granular control over usage.
How to set up API keys for an Enterprise account
Step 1 – Request API access
Contact your designated Magnific representative to request API access. Once it’s enabled, you’ll be able to generate API Keys directly from your Dashboard.
Step 2 – Access the API keys section
- Go back to the enterprise account page and refresh
- You will now see the API Keys section (currently in beta mode)
- There is also a link to the API docs available there
Step 3 – Generate an API key
- Click Generate
- Give it a name (e.g. "Heroes Test")
- Set a credit limit if needed
- Click Save API Key
Step 4 – Copy your key
- Once generated, copy the API key immediately
- You will not be able to see it again for security reasons
Step 5 – Manage your API key
- You can activate or deactivate keys at any time
- You can set permissions (e.g. audio models, 3D models)
- You can also delete a key if needed
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.
Each API generation requests — images, videos, audio, upscaling, editing, and more — deduct credits from your balance.
To use the API, you can choose from the following subscription plans:
- Business: 90K credits/month or 1.08M/year
- Enterprise: 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.
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.
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.
Can't find an answer to your question?
Our support team is here to help you with any questions or issues.
Submit a request