Passer au contenu

API Mage · Modèle d'image

API MOSS-Image

Prompts longs et texte bilingue, poids ouverts

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

En un coup d’œil

L'API MOSS-Image exécute MOSS-Image via Mage à l'adresse POST https://api.mage.space/v1/moss_image/generate. Une requête avec les paramètres par défaut coûte 25 Gems (environ 0,025 $), sans abonnement. MOSS-Image n'accepte pas les mentions @handle.

  • ImageSortie
  • 1Variante
  • 25Gems par image, par défaut
  • $0.025Environ, en USD

Présentation

Ce que fait l'API MOSS-Image

Un modèle de texte vers image à poids ouverts qui suit des prompts longs et détaillés et génère du texte en anglais et en chinois. Jusqu'à 2K avec des LoRA ; pas d'images de référence.

Un modèle d'image à poids ouverts pour les prompts longs et détaillés et le texte en anglais ou en chinois, en 1K ou 2K.

Il génère à partir du prompt seul.

Démarrage rapide

Appeler l'API MOSS-Image

Définis MAGE_API_KEY, envoie ta requête à /moss_image/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/moss_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": "4:5",
  "model_id": "moss-image"
}' | 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('moss_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'moss-image',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("moss_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "moss-image",
})

print(request["result"]["url"])

Modèles

Valeurs model_id de MOSS-Image

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
moss-imageMOSS-ImageOui

Options

Paramètres de MOSS-Image

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

ChampValeurs
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Autres modèles d'image

Autres API de génération d'images sur Mage

FAQ

Questions fréquentes

Combien coûte l'API MOSS-Image ?
Une requête MOSS-Image avec les paramètres par défaut (MOSS-Image) coûte 25 Gems, soit environ 0,025 $. Les autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle que bloque la politique de contenu de Mage ne l'est pas.
Quel est l'endpoint de l'API MOSS-Image ?
POST https://api.mage.space/v1/moss_image/generate avec un en-tête Authorization: Bearer contenant ta clé d'API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles MOSS-Image puis-je appeler ?
moss-image (MOSS-Image). Le modèle par défaut est MOSS-Image.
MOSS-Image prend-il en charge les images de référence ou les personnages ?
MOSS-Image n'accepte aucune entrée image, vidéo ou audio. MOSS-Image n'accepte pas les mentions @handle.
Puis-je utiliser MOSS-Image depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande MOSS-Image par son nom. Ton assistant lit ses options avec get_model et t'annonce le prix avant de générer.
Combien de temps les résultats MOSS-Image sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.