CheaperGen

Documentation de l’API MOSS Image

Tout ce dont vous avez besoin pour appeler MOSS Image depuis votre code. URL de base : https://cheapergen.com/api/v1. Essayez d’abord dans l’interface playground.

Vous utilisez un agent de programmation ?

Collez ceci dans Claude Code, Cursor, Codex ou tout autre agent de programmation. Il ajoute l’API à votre projet, conserve la clé dans CHEAPERGEN_API_KEY et teste le devis gratuit avant toute dépense.

Add MOSS Image (CheaperGen endpoint openmoss/moss-image/text-to-image) to this project by following https://cheapergen.com/agents/integrate.md
Ce que votre agent lit

Authentification

Créez une clé dans Tableau de bord → Clés API et envoyez-la comme jeton Bearer. Conservez les clés côté serveur.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API MOSS Image Texte en image

POST/api/v1/run/openmoss/moss-image/text-to-image

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

NomTypeDescriptionInflue sur le prix
promptrequisstringLangage naturel, tags séparés par des virgules ou mise en page JSON (description de la scène, puis éléments avec texte et boîtes englobantes exprimées en pixels depuis le centre du canevas). Mettez entre guillemets les mots exacts à afficher.Non
aspect_ratiostring (enum)Format de l’image générée. En 1K : 1:1 = 1024 × 1024, 4:5 = 912 × 1136, 5:4 = 1136 × 912, 3:4 = 880 × 1168, 4:3 = 1168 × 880, 2:3 = 832 × 1248, 3:2 = 1248 × 832, 9:16 = 768 × 1360, 16:9 = 1360 × 768, 1:2 = 720 × 1440, 2:1 = 1440 × 720, 9:21 = 656 × 1552, 21:9 = 1552 × 656, 1:3 = 576 × 1760, 3:1 = 1760 × 576.
Valeurs : 1:1 · 4:5 · 5:4 · 3:4 · 4:3 · 2:3 · 3:2 · 9:16 · 16:9 · 1:2 · 2:1 · 9:21 · 21:9 · 1:3 · 3:1
Par défaut : 1:1
Oui
resolutionstring (enum)Taille de sortie, au même prix quel que soit le format d’image : en 1:1, 1K = 1 MP (1024 × 1024), 1.5K ≈ 2,25 MP (1536 × 1536), 2K = 4 MP (2048 × 2048), avec 1 MP = 1024² px. Les autres formats conservent le même nombre de pixels : chaque côté correspond au côté en 1:1 × √ratio, arrondi à l’entier inférieur multiple de 16 (par ex. 2K en 16:9 = 2720 × 1536).
Valeurs : 1K · 1.5K · 2K
Par défaut : 1K
Oui
seedintegerRéutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.Non
enable_safety_checkerbooleanSi cette option est activée, la vérification de sécurité sera appliquée. Le contenu interdit par notre politique d’utilisation acceptable reste bloqué dans tous les cas.
Par défaut : true
Non
webhook_urlchaîne (URL)Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. WebhooksNon

Requête

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/openmoss/moss-image/text-to-image`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Pancarte en bois peinte à la main devant un salon de thé, avec le texte « 山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6 », brume matinale, lumière chaleureuse",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);

Réponse

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "openmoss/moss-image",
  "endpoint": "openmoss/moss-image/text-to-image",
  "mode": "text-to-image",
  "status": "queued",
  "input": {
    "prompt": "Pancarte en bois peinte à la main devant un salon de thé, avec le texte « 山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6 », brume matinale, lumière chaleureuse",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "reference",
    "list_price_label": "fal API",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

Récupérer le résultat

Les générations sont asynchrones. Interrogez leur état jusqu’à ce que status soit succeeded, failed ou canceled, ou indiquez webhook_url lors de l’envoi. Les générations échouées sont automatiquement remboursées.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Pour en savoir plus : cycle de vie des tâches · webhooks · erreurs

Tarifs de MOSS Image

Payez par image à l’usage, sans abonnement requis. Les générations échouées sont remboursées automatiquement.

OffreAPI de falCheaperGen
1K
1024 × 1024
$0,05/img$0,0384/img
Avec un forfait mensuel : Pro $0,0368Max $0,0352
1.5K
1536 × 1536
$0,1125/img$0,0826/img
Avec un forfait mensuel : Pro $0,0788Max $0,0749
2K
2048 × 2048
$0,20/img$0,1534/img
Avec un forfait mensuel : Pro $0,1469Max $0,1404

Forfaits mensuels vous fait bénéficier de tarifs réduits sur la plupart des modèles (indiqués sous chaque prix), tout en gardant le paiement à l’usage. Pro $499/mois · Max $4 999/mois.

  • API de fal : Prix public de fal pour MOSS Image : 0,05 $ par mégapixel, calculé sur le nombre de pixels de l’image de sortie (OpenMOSS ne vend pas d’API à l’international) — https://fal.ai/models/fal-ai/moss-image. Tarifs vérifiés le 22 octobre 2026.
  • Un prix unique par résolution, quel que soit le format d’image.