Mage API · Model obrazu

API Grok Image

Grok Imagine w trzech poziomach jakości

Zdobądź klucz APIWypróbuj Grok Image w playgroundzie
POST https://api.mage.space/v1/grok_image/generate

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.

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_idNazwaDomyślny
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualityTak
grok-imagine-image-2.0Grok 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.

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 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.

Zdobądź klucz APIWypróbuj Grok Image w playgroundzie

Powiązane