W skrócie
API Grok Image uruchamia przez Mage model Grok Image Quality i 2 inne warianty pod adresem POST https://api.mage.space/v1/grok_image/generate. Żądanie z ustawieniami domyślnymi kosztuje 75 Gems (około 0,075 USD), bez subskrypcji. Grok Image obsługuje zapisane postacie i referencje przez @handle w prompcie.
Obraz
Wynik
3
Warianty
75
Gems za obraz, domyślnie
$0.075
Około, w USD
Przegląd
Co robi API Grok Image
Model obrazów Grok Imagine od xAI w trzech poziomach jakości. Generuje lub edytuje na podstawie maksymalnie 3 obrazów referencyjnych, zachowując szczegóły źródła. Obowiązuje filtr bezpieczeństwa xAI.
Modele obrazów Grok Imagine od xAI w trzech poziomach jakości, do generowania i edycji na podstawie obrazów referencyjnych. 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-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
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-quality | Grok Image Quality | Tak |
| grok-imagine-image-2.0 | Grok Image 2.0 |
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
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 135 Gems
Mango API
Nasza flagowa rodzina modeli obrazu
Obraz · od 68 Gems
Nano Banana 2 API
Wyraźny, czytelny tekst, do 4K
Obraz · od 15 Gems
API SDXL Plus
SDXL z poprawionymi twarzami i dłońmi
FAQ
Najczęściej zadawane pytania
Ile kosztuje API Grok Image?
Żądanie Grok Image z ustawieniami domyślnymi (Grok Image Quality) kosztuje 75 Gems, czyli około 0,075 USD. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną kwotę podaje odpowiedź. Za nieudane generowanie zwracamy koszt, a za generowanie zablokowane przez zasady dotyczące treści Mage – nie.
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-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Domyślny to Grok Image Quality.
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.