Mage API · Model obrazu
API Grok Image
Grok Imagine w dwóch wersjach
POST https://api.mage.space/v1/grok_image/generateW 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_id | Nazwa | Domyślny |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Tak |
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.
| Pole | Wartości |
|---|---|
| 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 |
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.
| Pole | Rola |
|---|---|
| image | Obraz referencyjny. |
| additional_images | Dodatkowe obrazy referencyjne. |
Więcej modeli obrazów
Inne API do generowania obrazów w Mage
Guava API
Fotorealizm, który uchodzi za prawdziwe zdjęcie
HiDream API
Szybki i wszechstronny, z negatywnymi promptami
Krea 2 API
Zachwycająca estetyka w kilka sekund
Mango API
Nasza flagowa rodzina modeli obrazu
MiniMax H3 Image API
Natywne obrazy 16 megapikseli, otwarte wagi
MOSS-Image API
Długie prompty i tekst dwujęzyczny, otwarte wagi
FAQ
Najczęściej zadawane pytania
Ile kosztuje API Grok Image?
Jaki jest endpoint API Grok Image?
Które modele Grok Image mogę wywoływać?
Czy Grok Image obsługuje obrazy referencyjne lub postacie?
Czy mogę używać Grok Image w Claude lub ChatGPT?
Jak długo przechowywane są wyniki Grok Image?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.