Přeskočit na obsah

Mage API · Model pro obrázky

API Grok Image

Grok Imagine ve třech úrovních kvality

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

Stručně

API Grok Image spouští Grok Image Quality a 2 další varianty přes Mage na POST https://api.mage.space/v1/grok_image/generate. Požadavek s výchozím nastavením stojí 75 Gems (asi 0,075 $), bez předplatného. Grok Image umí používat uložené postavy a reference pomocí @handle v promptu.

  • ObrázekVýstup
  • 3Varianty
  • 75Gems za obrázek, výchozí
  • $0.075Přibližně v USD

Přehled

Co API Grok Image umí

Obrazový model Grok Imagine od xAI ve třech úrovních kvality. Generuje nebo upravuje až ze 3 referenčních obrázků a přitom zachovává detaily předlohy. Platí bezpečnostní filtr xAI.

Obrazové modely Grok Imagine od xAI ve třech úrovních kvality pro generování i úpravy z referenčních obrázků. Platí bezpečnostní filtr xAI.

Jako vstupy přijímá image, additional_images.

Rychlý start

Volání API Grok Image

Nastav MAGE_API_KEY, odešli požadavek na /grok_image/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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"])

Modely

Hodnoty model_id pro Grok Image

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualityAno
grok-imagine-image-2.0Grok Image 2.0

Možnosti

Parametry Grok Image

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
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

Vstupy

Mediální vstupy, které Grok Image přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.

Další modely pro obrázky

Další API pro generování obrázků na Mage

  • Obrázek · od 37 Gems

    Guava API

    Fotorealismus, který projde jako fotografie

  • Obrázky · od 20 Gems

    HiDream API

    Rychlý a univerzální, s negativními prompty

  • Obrázky · od 20 Gems

    Krea 2 API

    Nádherná estetika během pár sekund

  • Obrázek · od 135 Gems

    Mango API

    Naše vlajková řada obrázkových modelů

  • Obrázek · od 51 Gems

    Nano Banana 2 API

    Ostrý, čitelný text až do 4K

  • Obrázek · od 15 Gems

    API SDXL Plus

    SDXL s opravenými obličeji a rukama

Časté dotazy

Často kladené otázky

Kolik stojí API Grok Image?
Požadavek Grok Image s výchozím nastavením (Grok Image Quality) stojí 75 Gems, tedy asi 0,075 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku uvádí odpověď. Za neúspěšné generování se Gems vrátí; za generování zablokované pravidly obsahu Mage se nevrací.
Jaký je endpoint API Grok Image?
POST https://api.mage.space/v1/grok_image/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém si výsledek vyzvedneš.
Které modely Grok Image můžu volat?
grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Výchozí je Grok Image Quality.
Podporuje Grok Image referenční obrázky nebo postavy?
Grok Image přijímá image, additional_images. Grok Image umí používat uložené postavy a reference pomocí @handle v promptu.
Můžu používat Grok Image z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Grok Image jménem. Tvůj asistent si přečte jeho možnosti přes get_model a před generováním sdělí cenu.
Jak dlouho se výsledky Grok Image uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.