Treci la conținut

Mage API · Model de imagine

API Chroma

Open-weights, construit pe Flux

POST https://api.mage.space/v1/chroma/generate

Pe scurt

API-ul Chroma rulează Chroma prin Mage la POST https://api.mage.space/v1/chroma/generate. O cerere cu setările implicite costă 35 Gems (aproximativ 0,035 USD), fără abonament. Chroma nu acceptă mențiuni @handle.

  • ImagineRezultat
  • 1Variantă
  • 35Gems per imagine, implicit
  • $0.035Aproximativ, în USD

Prezentare generală

Ce face API-ul Chroma

Un model de imagini general, open-weights, pe arhitectura Flux. Generare de imagini din text, cu pașii și guidance-ul la îndemâna ta.

Un model de imagini de uz general, open-weights, pe arhitectura Flux.

Generează doar pe baza promptului.

Pornire rapidă

Apelează API-ul Chroma

Setează MAGE_API_KEY, trimite cererea la /chroma/generate și interoghează status_url până când cererea se termină.

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"])

Modele

Valori model_id pentru Chroma

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
chroma-v1-hdChromaDa

Opțiuni

Parametri Chroma

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

  • Imagine · de la 40 de Gems

    API Flux 2

    Prompturi lungi și editări cu mai multe referințe

  • Imagine · de la 9 Gems

    API GPT Image 2

    Prompturi precise și text lizibil

  • Imagine · de la 75 Gems

    API Grok Image

    Grok Imagine, în trei niveluri de calitate

  • Imagine · de la 37 de Gems

    API Guava

    Fotorealism care trece drept fotografie

  • Imagine · de la 20 Gems

    API HiDream

    Rapid și versatil, cu prompturi negative

  • Imagine · de la 20 Gems

    API Krea 2

    Estetică spectaculoasă în câteva secunde

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Chroma?
O cerere Chroma cu setările implicite (Chroma) costă 35 de Gems, adică aproximativ 0,035 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică suma exactă taxată. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Chroma?
POST https://api.mage.space/v1/chroma/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi periodic pentru a afla rezultatul.
Ce modele Chroma pot apela?
chroma-v1-hd. Modelul implicit este Chroma.
Chroma acceptă imagini de referință sau personaje?
Chroma nu acceptă imagini, videoclipuri sau fișiere audio ca intrări. Chroma nu acceptă mențiuni @handle.
Pot folosi Chroma din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Chroma pe nume. Asistentul tău își citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Chroma?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.