In breve
L'API di Grok Image esegue Grok Image Quality e altre 2 varianti tramite Mage su POST https://api.mage.space/v1/grok_image/generate. Una richiesta con le impostazioni predefinite costa 75 Gems (circa 0,075 $), senza abbonamento. Grok Image usa Characters e References salvati tramite @handle nel prompt.
Immagine
Output
3
Varianti
75
Gems per immagine, predefinito
$0.075
Circa, in USD
Panoramica
Cosa fa l'API di Grok Image
Il modello di immagini Grok Imagine di xAI in tre livelli di qualità. Genera o modifica a partire da un massimo di 3 immagini di riferimento, mantenendo intatti i dettagli della fonte. Si applica il filtro di sicurezza di xAI.
I modelli di immagini Grok Imagine di xAI in tre livelli di qualità, per generare e modificare a partire da immagini di riferimento. Si applica il filtro di sicurezza di xAI.
Accetta come input image, additional_images.
Guida rapida
Chiama l'API di Grok Image
Imposta MAGE_API_KEY, invia la richiesta a /grok_image/generate e controlla status_url finché la richiesta non è completata.
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"])Modelli
Valori di model_id per Grok Image
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-quality | Grok Image Quality | Sì |
| grok-imagine-image-2.0 | Grok Image 2.0 |
Opzioni
Parametri di Grok Image
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| 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 |
Input
Input multimediali accettati da Grok Image
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
Altri modelli di immagini
Altre API di generazione di immagini su Mage
Immagine · da 37 Gems
API Guava
Un fotorealismo che sembra una vera fotografia
Immagine · da 20 Gems
API HiDream
Veloce e versatile, con prompt negativi
Immagine · da 20 Gems
API di Krea 2
Estetica stupenda in pochi secondi
Immagine · da 135 Gems
API Mango
La nostra famiglia di modelli immagine di punta
Immagine · da 68 Gems
API Nano Banana 2
Testo nitido e leggibile, fino a 4K
Immagine · da 15 Gems
API di SDXL Plus
SDXL con volti e mani corretti
FAQ
Domande frequenti
Quanto costa l'API di Grok Image?
Una richiesta a Grok Image con le impostazioni predefinite (Grok Image Quality) costa 75 Gems, circa 0,075 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'importo esatto addebitato. Una generazione che non va a buon fine viene rimborsata; una bloccata dalla policy sui contenuti di Mage no.
Qual è l'endpoint dell'API di Grok Image?
POST https://api.mage.space/v1/grok_image/generate con un header Authorization: Bearer che contiene la tua chiave API di Mage. La risposta include uno status_url da controllare per ottenere il risultato.
Quali modelli Grok Image posso chiamare?
grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Il modello predefinito è Grok Image Quality.
Grok Image supporta immagini di riferimento o personaggi?
Grok Image accetta image, additional_images. Grok Image usa Characters e References salvati tramite @handle nel prompt.
Posso usare Grok Image da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Grok Image per nome. Il tuo assistente legge le opzioni con get_model e indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Grok Image?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.