Treci la conținut

Mage API · Model de imagine

API Grok Image

Grok Imagine, în trei niveluri de calitate

POST https://api.mage.space/v1/grok_image/generate

Pe 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_idNumeImplicit
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualityDa
grok-imagine-image-2.0Grok 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âmpValori
aspect_ratio1: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
resolution1k, 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âmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

  • Imagine · de la 37 de Gems

    API Guava

    Fotorealism care trece drept fotografie

  • Imagine · de la 20 Gems

    API HiDream

    Rapid și versatil, cu prompturi negative

  • Imagine · de la 20 Gems

    API Krea 2

    Estetică spectaculoasă în câteva secunde

  • Imagine · de la 135 de Gems

    API Mango

    Familia noastră principală de modele de imagine

  • Imagine · de la 51 de Gems

    API Nano Banana 2

    Text clar și lizibil, până la 4K

  • Imagine · de la 15 Gems

    API SDXL Plus

    SDXL cu fețe și mâini corectate

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Grok Image?
O cerere Grok Image cu setările implicite (Grok Image Quality) costă 75 Gems, aproximativ 0,075 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Grok Image?
POST https://api.mage.space/v1/grok_image/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru a obține rezultatul.
Ce modele Grok Image pot apela?
grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Modelul implicit este Grok Image Quality.
Acceptă Grok Image imagini de referință sau personaje?
Grok Image acceptă image, additional_images. Grok Image folosește personaje și referințe salvate, prin @handle în prompt.
Pot folosi Grok Image din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Grok Image pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Grok Image?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.