Mage API · Model de imagine
API Grok Image
Grok Imagine, în trei niveluri de calitate
POST https://api.mage.space/v1/grok_image/generatePe scurt
API-ul Grok Image rulează Grok Image Quality și alte 2 variante prin Mage la POST https://api.mage.space/v1/grok_image/generate. O cerere cu setările implicite costă 75 Gems (aproximativ 0,075 $), fără abonament. Grok Image folosește personaje și referințe salvate, prin @handle în prompt.
- ImagineRezultat
- 3Variante
- 75Gems per imagine, implicit
- $0.075Aproximativ, în USD
Prezentare generală
Ce face API-ul Grok Image
Modelul de imagini Grok Imagine de la xAI, în trei niveluri de calitate. Generează sau editează pornind de la până la 3 imagini de referință, păstrând intacte detaliile sursei. Se aplică filtrul de siguranță xAI.
Modelele de imagini Grok Imagine de la xAI, în trei niveluri de calitate, pentru generare și editări pornind de la imagini de referință. Se aplică filtrul de siguranță xAI.
Acceptă ca intrări image, additional_images.
Pornire rapidă
Apelează API-ul Grok Image
Setează MAGE_API_KEY, trimite cererea la /grok_image/generate și interoghează status_url până se finalizează cererea.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-quality"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('grok_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-quality',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-quality",
})
print(request["result"]["url"])Modele
Valorile model_id pentru Grok Image
Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.
| model_id | Nume | Implicit |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-quality | Grok Image Quality | Da |
| grok-imagine-image-2.0 | Grok Image 2.0 |
Opțiuni
Parametrii Grok Image
Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.
| Câmp | Valori |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20 |
| resolution | 1k, 2k |
Intrări
Intrări media acceptate de Grok Image
Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.
| Câmp | Rol |
|---|---|
| image | Imaginea de referință. |
| additional_images | Imagini de referință suplimentare. |
Mai multe modele de imagini
Alte API-uri de generare de imagini pe Mage
API Guava
Fotorealism care trece drept fotografie
API HiDream
Rapid și versatil, cu prompturi negative
API Krea 2
Estetică spectaculoasă în câteva secunde
API Mango
Familia noastră principală de modele de imagine
API Nano Banana 2
Text clar și lizibil, până la 4K
API SDXL Plus
SDXL cu fețe și mâini corectate
Întrebări frecvente
Întrebări frecvente
Cât costă API-ul Grok Image?
Care este endpoint-ul API-ului Grok Image?
Ce modele Grok Image pot apela?
Acceptă Grok Image imagini de referință sau personaje?
Pot folosi Grok Image din Claude sau ChatGPT?
Cât timp sunt păstrate rezultatele Grok Image?
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.