Przejdź do treści

Mage API · Model obrazu

API Grok Image

Grok Imagine w dwóch wersjach

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

W skrócie

Grok Image API uruchamia Grok Image 2.0 i jeszcze jeden wariant przez Mage pod adresem POST https://api.mage.space/v1/grok_image/generate. Zapytanie z ustawieniami domyślnymi kosztuje 90 Gems (ok. 0,09 USD), bez subskrypcji. Grok Image obsługuje zapisane postaci i referencje podawane w prompcie przez @handle.

  • ObrazWynik
  • 2Warianty
  • 90Gems za obraz, domyślnie
  • $0.09Około, w USD

Przegląd

Co robi API Grok Image

Model obrazów Grok Imagine od xAI w dwóch wersjach. Generuje lub edytuje obrazy na podstawie maksymalnie 3 obrazów referencyjnych, zachowując szczegóły oryginału. Obowiązuje filtr bezpieczeństwa xAI.

Modele obrazów Grok Imagine od xAI w dwóch wersjach, do generowania i edycji na podstawie obrazów referencyjnych: Grok Image 2.0 (`grok-imagine-image-2.0`), domyślny, oraz Grok Image (`grok-imagine-image`) do tanich szkiców. xAI wycofało Grok Image Quality (`grok-imagine-image-quality`) 2 listopada 2026 r., a zapytanie z jego nazwą zostanie odrzucone. Obowiązuje filtr bezpieczeństwa xAI.

Przyjmuje dane wejściowe: image, additional_images.

Szybki start

Wywołaj API Grok Image

Ustaw MAGE_API_KEY, wyślij żądanie na /grok_image/generate i odpytuj status_url, aż żądanie zostanie zrealizowane.

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-2.0"
}' | 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-2.0',
});

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-2.0",
})

print(request["result"]["url"])

Modele

Wartości model_id dla Grok Image

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Tak

Opcje

Parametry Grok Image

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
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

Dane wejściowe

Dane wejściowe, które akceptuje Grok Image

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

  • Obraz · od 37 Gems

    Guava API

    Fotorealizm, który uchodzi za prawdziwe zdjęcie

  • Obraz · od 20 Gems

    HiDream API

    Szybki i wszechstronny, z negatywnymi promptami

  • Obraz · od 20 Gems

    Krea 2 API

    Zachwycająca estetyka w kilka sekund

  • Obraz · od 42 Gems

    Mango API

    Nasza flagowa rodzina modeli obrazu

  • Obraz · od 15 Gems

    MiniMax H3 Image API

    Natywne obrazy 16 megapikseli, otwarte wagi

  • Obraz · od 25 Gems

    MOSS-Image API

    Długie prompty i tekst dwujęzyczny, otwarte wagi

FAQ

Najczęściej zadawane pytania

Ile kosztuje API Grok Image?
Zapytanie Grok Image z ustawieniami domyślnymi (Grok Image 2.0) kosztuje 90 Gems, czyli około 0,09 USD. Inne rozdzielczości, długości i warianty zmieniają cenę, a dokładną opłatę podaje odpowiedź. Za nieudaną generację zwracamy Gems, ale nie za tę, którą zablokuje polityka treści Mage.
Jaki jest endpoint API Grok Image?
POST https://api.mage.space/v1/grok_image/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele Grok Image mogę wywoływać?
grok-imagine-image (Grok Image), grok-imagine-image-2.0 (Grok Image 2.0). Domyślny to Grok Image 2.0.
Czy Grok Image obsługuje obrazy referencyjne lub postacie?
Grok Image akceptuje image, additional_images. Grok Image obsługuje zapisane postacie i referencje przez @handle w prompcie.
Czy mogę używać Grok Image w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Grok Image po nazwie. Twój asystent odczyta jego opcje przez get_model i poda cenę, zanim zacznie generować.
Jak długo przechowywane są wyniki Grok Image?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

CharactersSpołeczność