Ga naar de inhoud

Mage API · Beeldmodel

Chroma API

Open weights, gebouwd op Flux

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

In één oogopslag

De Chroma API draait Chroma via Mage op POST https://api.mage.space/v1/chroma/generate. Een verzoek met de standaardinstellingen kost 35 Gems (ongeveer $0,035), zonder abonnement. Chroma accepteert geen @handle-vermeldingen.

  • AfbeeldingUitvoer
  • 1Variant
  • 35Gems per afbeelding, standaard
  • $0.035Ongeveer, in USD

Overzicht

Wat de Chroma API doet

Een algemeen beeldmodel met open weights op de Flux-architectuur. Tekst-naar-afbeelding, waarbij jij de stappen en de guidance bepaalt.

Een algemeen beeldmodel met open weights op de Flux-architectuur.

Het genereert alleen op basis van de prompt.

Snel starten

De Chroma API aanroepen

Stel MAGE_API_KEY in, stuur je verzoek naar /chroma/generate en poll status_url tot het verzoek is voltooid.

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

Modellen

Chroma model_id-waarden

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

model_idNaamStandaard
chroma-v1-hdChromaJa

Opties

Chroma-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

VeldWaarden
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Meer beeldmodellen

Andere API's voor beeldgeneratie op Mage

  • Afbeelding · vanaf 40 Gems

    Flux 2 API

    Lange prompts en bewerkingen met meerdere referenties

  • Afbeelding · vanaf 9 Gems

    GPT Image 2 API

    Nauwkeurige prompts en leesbare tekst

  • Afbeelding · vanaf 90 Gems

    Grok Image API

    Grok Imagine, in twee varianten

  • Afbeelding · vanaf 37 Gems

    Guava API

    Fotorealisme dat voor een echte foto doorgaat

  • Afbeelding · vanaf 20 Gems

    HiDream API

    Snel en veelzijdig, met negatieve prompts

  • Afbeelding · vanaf 20 Gems

    Krea 2 API

    Prachtige esthetiek in enkele seconden

FAQ

Veelgestelde vragen

Hoeveel kost de Chroma API?
Een Chroma-verzoek met de standaardinstellingen (Chroma) kost 35 Gems, ongeveer $0,035. Andere resoluties, duur en varianten veranderen de prijs; de respons geeft de exacte kosten weer. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Chroma API?
POST https://api.mage.space/v1/chroma/generate met een Authorization: Bearer-header met je Mage API-sleutel. De respons bevat een status_url die je kunt pollen voor het resultaat.
Welke Chroma-modellen kan ik aanroepen?
chroma-v1-hd. De standaard is Chroma.
Ondersteunt Chroma referentiebeelden of personages?
Chroma accepteert geen afbeeldingen, video's of audio als invoer. Chroma accepteert geen @handle-vermeldingen.
Kan ik Chroma gebruiken vanuit Claude of ChatGPT?
Ja. Koppel de Mage MCP-server aan Claude, ChatGPT, Claude Code, Grok of Cursor en vraag op naam om Chroma. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.
Hoe lang worden Chroma-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

CharactersCommunity