docs.emix.ai
language
language
  • πŸ‡ΊπŸ‡Έ English
  • πŸ‡¨πŸ‡³ Chinese
language
language
  • πŸ‡ΊπŸ‡Έ English
  • πŸ‡¨πŸ‡³ Chinese
Market
File Upload API
Market
File Upload API
  1. Market
  • Getting Started with Emix API (Important)
  • Market
  • Image Models
    • Seedream
      • Seedream4.5 - Text to Image
      • Seedream4.5 - Edit
      • Seedream5.0 Lite - Text to Image
      • Seedream5.0 Lite - Image to Image
      • Seedream5.0 Pro - Text to Image
      • Seedream5.0 Pro - Image to Image
    • Google
      • Google - Nano Banana
      • Google - Nano Banana Pro
      • Google - Nano Banana 2
      • Google - Nano Banana 2 Lite
    • Grok Imagine
      • Grok Imagine - Text to Image
      • Grok Imagine - image to image
    • GPT Image
      • GPT Image-1.5 - Text to Image
      • GPT Image-1.5 - Image to Image
      • GPT Image-2 - Text to Image
      • GPT Image 2 - Image To Image
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
  • Video Models
    • Grok Imagine
      • Grok Imagine Text to Video
      • Grok Imagine Image to Video
      • Grok Imagine - Video Upscale
      • Grok Imagine - Video Extend
      • Grok Imagine Video 1.5 Preview
    • Kling
      • Kling 2.6 Text to Video
      • Kling 2.6 Image to Video
      • Kling AI Avatar Standard
      • Kling AI Avatar Pro
      • Kling V2.1 Master Image to Video
      • Kling V2.1 Master Text to Video
      • Kling V2.1 Pro
      • Kling V2.1 Standard
      • Kling 2.6 motion-control
      • Kling-3.0 motion-control
      • Kling 3.0
    • Bytedance
      • Bytedance Seedance 2.0
      • Bytedance Seedance 2.0 Fast
      • Bytedance Seedance 2.0 Mini
    • Veo3.1 API
      • VEO 3.1 Text to video
      • VEO 3.1 Image to video
      • VEO 3.1 Reference to vidoe
    • Wan
      • Wan 2.6 - Image to Video
      • Wan 2.6 - Text to Video
      • Wan 2.6 - Video to Video
      • Wan 2.7 - Text to Video
      • Wan 2.7 - Image to Video
      • Wan 2.7 - Video Edit
      • Wan 2.7 - Reference to Video
    • HappyHorse
      • HappyHorse-1-1 image-to-video
      • HappyHorse-1-1 text-to-video
      • HappyHorse-1-1 reference-to-video
    • Gemini Omni
      • Gemini Omni Video
      • Gemini Omni Audio
      • Gemini Omni Character
  • Chat Models
    • Claude
      • Claude Code + emix.ai Integration Guide
      • Claude Sonnet 5
    • Gemini
      • Gemini 3.5 Flash (openai)
    • Grok
      • Grok 4.5
      • Grok 4.3
  • Get Task Details
    GET
  1. Market

Getting Started with Emix API (Important)

Welcome to EMIX. This guide walks you through the essential information you need to start integrating Emix APIs into your product, including models, pricing, authentication, request flow, limits, and support.
We aim to be transparent, practical, and developer-friendly. Please read this carefully before going to production.

1. Available Models & Playground#

You can find the latest supported models on our Market page:
πŸ‘‰ https://emix.ai/market
We continuously update and onboard new models as soon as they are stable.
Each model page links to its Playground, where you can test and experiment directly in our UI before calling the API.
The Playground is the best place to understand model behavior, parameters, and output formats.

2. Pricing#

The complete and up-to-date pricing list is available here:
πŸ‘‰ https://emix.ai/pricing
Our prices are typically 30%–50% lower than official APIs.
For some models, discounts can reach up to 80%.
Pricing may change as upstream providers adjust their costs, so always refer to the pricing page for the latest numbers.

3. Creating and Securing Your API Key#

Create and manage your API keys here:
πŸ‘‰ https://emix.ai/api-key
Important security notes:
Never expose your API key in frontend code (browser, mobile apps, public repositories).
Treat your API key as a secret.
To help protect your usage, we provide:
Rate limits per key (hourly, daily, and total usage caps)
IP whitelist support, allowing only approved server IPs to access the API
These features help prevent accidental overuse and unauthorized requests.

4. Required Request Headers#

Every API request must include the correct headers:
If these headers are missing or incorrect, you may receive:
{"code":401,"msg":"You do not have access permissions"}
Always double-check your headers when debugging authentication issues.

5. Logs & Task Details#

You can inspect all your historical tasks here:
πŸ‘‰ https://emix.ai/logs
For each task, you can view:
Creation time
Model used
Input parameters
Task status
Credit consumption
Final results or error details
If you ever suspect incorrect credit usage, this page is the source of truth for verification.

6. Data Retention Policy#

Please note our retention rules:
Generated media files: stored for 14 days, then automatically deleted
Log records (text / metadata): stored for 2 months, then automatically deleted
If you need long-term access, make sure to download and store results on your side in time.

7. Asynchronous Task Model#

All generation tasks on Emix are asynchronous.
A successful request returns:
HTTP 200
A task_id
Status Verification
A 200 OK response only means the task was successfully created. It does not mean the task is completed.
To get the final result, you must either:
Provide a callback (webhook) URL in the request, or
Actively poll the "query record info" API using the task_id

8. Rate Limits & Concurrency#

By default, we apply the following limits:
Up to 20 new generation requests per 10 seconds
This typically allows 100+ concurrent running tasks
Limits are applied per account
If you exceed the limit:
Requests will be rejected with HTTP 429
Rejected requests will not enter the queue
For most users, this is more than sufficient.
If you consistently hit 429 errors, you may contact support to request a higher limit β€” approvals are handled cautiously.

9. Developer Support#

The recommended support channels are available directly from the dashboard (bottom-left menu):
Get help on Discord
Get help on Telegram
What you get:
Private, 1-on-1 channels
Your data and conversations remain confidential
Faster and more technical responses
Support hours:
UTC 21:00 – UTC 17:00 (next day)
You may also email us at support@emix.ai, but this is not the preferred or fastest option.

10. Stability Expectations#

We provide access to top-tier, highly competitive APIs at very aggressive pricing.
That said:
We are not perfect
Our overall stability may be slightly lower than official providers
This is a conscious trade-off
In practice, Emix is stable enough to support production workloads and long-term business growth, but we believe in setting realistic expectations upfront.

11. About the Team#

Emix is built by a small startup team.
We move fast
We care deeply about developer experience
We are constantly improving
At the same time, we acknowledge that:
Not everything is perfect
We can't satisfy every use case immediately
Your feedback helps us improve β€” and we genuinely appreciate it.
Next
Market
Built with