Mage API · Modele
28 de modele de generare, un singur API
Toate modelele de imagine, video și audio rulate de Mage API, cu ce știe să facă cel mai bine fiecare, valorile model_id și prețul la setările implicite.
POST https://api.mage.space/v1/{model}/generatePe scurt
Mage API rulează 15 modele de imagine, 12 modele video și 1 model audio la https://api.mage.space/v1/{model}/generate. Toate modelele folosesc aceeași cheie, același ciclu de cerere și aceleași nume de câmpuri, iar plata se face per generare, în Gems.
- 15Modele de imagine
- 12Modele video
- 1Modele audio
- 1O singură cheie API pentru toate
Modele de imagine
Modele de generare de imagini
Prețurile sunt per generare, în Gems. 1.000 de Gems costă $1 în pachetul standard, iar pachetele mai mari adaugă Gems bonus. Prețul depinde de model, rezoluție și durată; se afișează prețul pentru setările implicite, iar fiecare răspuns indică suma exactă în billing.gems_charged. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
| Model | Ideal pentru | Valori model_id | Preț implicit |
|---|---|---|---|
| Anima | Creat special pentru anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, construit pe Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Prompturi lungi și editări cu mai multe referințe | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompturi precise și text lizibil | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, în trei niveluri de calitate | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Fotorealism care trece drept fotografie | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Rapid și versatil, cu prompturi negative | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Estetică superbă în câteva secunde | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Familia noastră de imagini de top | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Text clar, lizibil, până la 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL cu fețe și mâini corectate | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | Clasicul, la preț mic | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion-ul care ascultă cel mai bine | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL optimizat pentru fotorealism | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Cel mai rapid model de imagini de pe Mage | z-image-turbo | 10 Gems ($0.01) |
Modele video
Modele de generare video
| Model | Ideal pentru | Valori model_id | Preț implicit |
|---|---|---|---|
| Berry | Video fidel referințelor tale | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fixează primul și ultimul cadru | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Familia noastră video principală | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, în mișcare | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video de zi cu zi, fără configurare | kiwi | 270 Gems ($0.27) |
| Lemon | Toate funcțiile video, la un preț mai prietenos | lemon | 245 Gems ($0.245) |
| LTX Video | Video open-weights rapid pentru iterații | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime în mișcare, cu audio opțional | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Video open rapid, cu sunet stereo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Sunet la fiecare clip, până la 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Personaje aduse la viață dintr-un prim cadru | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Video open-weights cu o variantă Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Modele audio
Modele de generare audio
| Model | Ideal pentru | Valori model_id | Preț implicit |
|---|---|---|---|
| Seed Audio | Voci, muzică și efecte sonore dintr-un singur prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Întrebări frecvente
Întrebări frecvente
Cât costă API-ul Mage?
Nu există abonament sau taxă lunară. Fiecare generare se plătește în Gems, la prețul afișat al modelului, iar 1.000 de Gems costă 1 $ la pachetul standard. Pagina fiecărui model afișează prețul cu setările implicite, iar fiecare răspuns indică taxarea exactă. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este. O cerere pe care soldul tău nu o poate acoperi este refuzată înainte de orice taxare.
Am nevoie de un abonament Mage ca să folosesc API-ul?
Nu. API-ul funcționează exclusiv cu Gems. Planurile de abonament și generarea nelimitată din aplicație nu se aplică cererilor API, deci orice cont Mage cu Gems îl poate apela.
Pot folosi rezultatele din API în scop comercial?
Da. Conținutul creat cu Mage, inclusiv prin API și serverul MCP, poate fi folosit în scop comercial. Menționarea sursei este apreciată, dar nu este obligatorie.
Care sunt limitele de utilizare?
Un cont poate avea simultan 20 de generări în coadă sau în curs. O trimitere peste această limită este refuzată cu 429 și nu costă nimic. Scrie la [email protected] pentru a crește limita pentru cazul tău de utilizare.
Poate agentul meu AI să folosească API-ul Mage?
Da. Agenții pot apela API-ul REST cu o cheie sau se pot conecta la serverul MCP Mage, care oferă Claude, ChatGPT, Claude Code, Grok și Cursor șaisprezece instrumente gata făcute pentru alegerea unui model, afișarea prețului, generare și preluarea rezultatului. Vezi serverul MCP.
Există un SDK pentru API-ul Mage?
Da. Pachetul oficial @mage-space/sdk de pe npm și mage-space de pe PyPI sunt open source și tipizate pentru fiecare model. Trimit cererea, așteaptă rezultatul, reîncearcă în siguranță și încarcă fișiere în locul tău. Utilizatorii ComfyUI pot instala pachetul de noduri comfyui-mage. Vezi SDK-urile Mage.
Folosesc deja alt API de generare. Ce trebuie să schimb?
Îndreaptă clientul către https://api.mage.space/v1, trimite cheia Mage ca token Bearer și asociază-ți câmpurile cu pagina modelului: prompt, aspect_ratio, resolution, duration și model_id funcționează la fel pentru toate modelele Mage. Cererile sunt asincrone, așa că trimite cererea și apoi interoghează periodic status_url.
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.