API di Mage · Modello per immagini
API di Grok Image
Grok Imagine, in due livelli
POST https://api.mage.space/v1/grok_image/generateIn breve
L'API Grok Image esegue Grok Image 2.0 e un'altra variante tramite Mage su POST https://api.mage.space/v1/grok_image/generate. Una richiesta con le impostazioni predefinite costa 90 Gems (circa 0,09 $), senza abbonamento. Grok Image accetta personaggi salvati e riferimenti tramite @handle nel prompt.
- ImmagineOutput
- 2Varianti
- 90Gems per immagine, predefinito
- $0.09Circa, in USD
Panoramica
Cosa fa l'API di Grok Image
Il modello di immagini Grok Imagine di xAI in due livelli. 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 due livelli, per generare e modificare a partire da immagini di riferimento: Grok Image 2.0 (`grok-imagine-image-2.0`), quello predefinito, e Grok Image (`grok-imagine-image`) per bozze economiche. xAI ha ritirato Grok Image Quality (`grok-imagine-image-quality`) il 2 novembre 2026, e una richiesta che lo indica viene rifiutata. 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-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"])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-2.0 | Grok Image 2.0 | Sì |
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
API Guava
Un fotorealismo che sembra una vera fotografia
API HiDream
Veloce e versatile, con prompt negativi
API di Krea 2
Estetica stupenda in pochi secondi
API Mango
La nostra famiglia di modelli immagine di punta
MiniMax H3 Image API
Immagini native da 16 megapixel, pesi aperti
API MOSS-Image
Prompt lunghi e testo bilingue, pesi aperti
FAQ
Domande frequenti
Quanto costa l'API di Grok Image?
Qual è l'endpoint dell'API di Grok Image?
Quali modelli Grok Image posso chiamare?
Grok Image supporta immagini di riferimento o personaggi?
Posso usare Grok Image da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Grok Image?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.