In breve
L'API Chroma esegue Chroma tramite Mage su POST https://api.mage.space/v1/chroma/generate. Una richiesta con le impostazioni predefinite costa 35 Gems (circa 0,035 $), senza abbonamento. Chroma non accetta menzioni @handle.
Immagine
Output
1
Variante
35
Gems per immagine, predefinito
$0.035
Circa, in USD
Panoramica
Cosa fa l'API Chroma
Un modello di immagini generico open-weights con architettura Flux. Da testo a immagine, con step e guidance in mano tua.
Un modello di immagini generico open-weights con architettura Flux.
Genera partendo solo dal prompt.
Guida rapida
Chiama l'API Chroma
Imposta MAGE_API_KEY, invia la richiesta a /chroma/generate e interroga status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/chroma/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "chroma-v1-hd"
}' | 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('chroma', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'chroma-v1-hd',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("chroma", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "chroma-v1-hd",
})
print(request["result"]["url"])Modelli
Valori model_id di Chroma
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| chroma-v1-hd | Chroma | Sì |
Opzioni
Parametri di Chroma
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Altri modelli di immagini
Altre API di generazione di immagini su Mage
Immagine · da 40 Gems
API Flux 2
Prompt lunghi e modifiche con più riferimenti
Immagine · da 9 Gems
API GPT Image 2
Prompt precisi e testo leggibile
Immagine · da 75 Gems
API Grok Image
Grok Imagine, in tre livelli di qualità
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
FAQ
Domande frequenti
Quanto costa l'API di Chroma?
Una richiesta Chroma con le impostazioni predefinite (Chroma) costa 35 Gems, circa $0,035. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta riporta l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
Qual è l'endpoint dell'API di Chroma?
POST https://api.mage.space/v1/chroma/generate con un header Authorization: Bearer contenente la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.
Quali modelli Chroma posso chiamare?
chroma-v1-hd. Il modello predefinito è Chroma.
Chroma supporta immagini di riferimento o personaggi?
Chroma non accetta input di immagini, video o audio. Chroma non accetta menzioni @handle.
Posso usare Chroma da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Chroma per nome. Il tuo assistente legge le sue opzioni con get_model e indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Chroma?
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.