O OpenMOSSチュートリアル

MOSS Image APIの使い方

MOSS Image APIの手順付きチュートリアル（Node.js、Python、cURL）。テキストから画像を生成ジョブを送信して、ポーリングまたはWebhookで状況を確認し、imageをダウンロードします。下記の例の料金は$0.039です。

エンドポイント: 1; テキストから画像を生成
リクエスト例: $0.039; テキストから画像を生成
言語: 3; Node.js · Python · cURL
失敗した実行: $0; 自動返金

APIキーを取得 MOSS Imageで作成 APIドキュメント

APIキーを取得

アカウントを作成し、クレジットを追加して、ダッシュボード → APIキーからキーを作成します。CHEAPERGEN_API_KEY サーバーに保存します。すべてのリクエストでBearerトークンとして送信してください。として保存してください。

MOSS Image APIキーの取得方法

MOSS Imageのエンドポイントを選択

タスクごとに専用のエンドポイントがあります。どのエンドポイントもJSON本文を受け取り、ポーリング可能な生成情報を返します。

MOSS Image APIエンドポイント、必須入力、料金
タスク	エンドポイント	必須	開始価格
テキストから画像を生成	openmoss/moss-image/text-to-image	prompt	$0.0384 画像1枚あたり

テキストから画像を生成ジョブを送信

このプログラムはジョブを送信し、完了するまで3秒ごとにポーリングして、image URLを表示します。プロンプトと設定を独自の内容に置き換えてください。

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": "茶店の外にある手描きの木製看板。「山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6」と書かれている。朝もやと温かな光。",
    "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);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/openmoss/moss-image/text-to-image", headers=headers, json={
    "prompt": "茶店の外にある手描きの木製看板。「山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6」と書かれている。朝もやと温かな光。",
    "aspect_ratio": "1:1",
    "resolution": "1K"
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["images"][0]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/openmoss/moss-image/text-to-image \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "茶店の外にある手描きの木製看板。「山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6」と書かれている。朝もやと温かな光。",
  "aspect_ratio": "1:1",
  "resolution": "1K"
}'

重要なパラメーターを設定する

各設定の内容と料金への影響（openmoss/moss-image/text-to-image）。

MOSS Imageのテキストから画像を生成パラメーターと料金への影響
パラメーター	型 · デフォルト値	説明	料金への影響
aspect_ratio	string (enum) · 1:1	出力画像の形状。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。 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	1:1: $0.0384 画像1枚あたり
resolution	string (enum) · 1K	出力サイズ。アスペクト比にかかわらず料金は同じです：1K = 1 MP（1024 × 1024）、1.5K ≈ 2.25 MP（1536 × 1536）、2K = 4 MP（2048 × 2048、1:1）。1 MP = 1024² pxです。ほかの比率でも画素数を保ち、各辺は1:1の辺の長さ × √比率を計算して16の倍数に切り捨てます（例：2K、16:9 = 2720 × 1536）。 1K · 1.5K · 2K	1K: $0.0384 画像1枚あたり 1.5K: $0.0826 画像1枚あたり 2K: $0.1534 画像1枚あたり
seed	integer	同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。	なし
enable_safety_checker	boolean · true	trueに設定すると、安全性チェッカーが有効になります。どちらの設定でも、当社の利用規定で禁止されているコンテンツはブロックされます。	なし

結果を取得する

ジョブはqueuedからrunningを経て、succeeded、failed、またはcanceledに移行します。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定すると結果をPOSTでお届けします。出力はダウンロードして、ご自身で保存してください。

200 — 成功

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "openmoss/moss-image",
  "endpoint": "openmoss/moss-image/text-to-image",
  "mode": "text-to-image",
  "status": "succeeded",
  "input": {
    "prompt": "茶店の外にある手描きの木製看板。「山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6」と書かれている。朝もやと温かな光。",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  },
  "output": {
    "images": [
      {
        "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q-0.png",
        "content_type": "image/png",
        "width": 2048,
        "height": 2048
      }
    ]
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "reference",
    "list_price_label": "fal API",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Webhook署名を検証する

実行前にリクエストの料金を確認する

見積もりエンドポイントは無料で、APIキーも不要です。送信した入力内容に対する料金、fal APIの料金、割引額を返します。

curl -X POST https://cheapergen.com/api/v1/quote/openmoss/moss-image/text-to-image \
  -H "Content-Type: application/json" \
  -d '{"prompt":"茶店の外にある手描きの木製看板。「山间茶舍 MOUNTAIN TEA HOUSE — OPEN DAILY 9–6」と書かれている。朝もやと温かな光。","aspect_ratio":"1:1","resolution":"1K"}'

APIエラーと対処方法
ステータス	コード	内容
400	invalid_request	必須パラメーターが不足しているか、範囲外です。エラーメッセージに該当項目が示されます。
401	unauthorized	APIキーがない、形式が不正、または失効しています。
402	insufficient_balance	見積もり料金に対してクレジットが不足しています。チャージするか、自動チャージを有効にしてください。
429	rate_limited	リクエスト数または実行中の生成数が多すぎます。間隔を空けて再試行してください。
502	upstream_error	モデルの提供元でエラーが発生しました。確保額は返金されるため、再試行できます。
503	model_unavailable	現在、正常に利用できるルートがありません。後でもう一度試すか、別のモデルを選んでください。

MOSS Image APIの完全版ドキュメント

よくある質問

MOSS Image APIに関するよくある質問

いいえ。APIはJSONを使った通常のHTTPS通信なので、このページにあるNode.js（fetch）とPython（requests）の例は、そのまま動作するプログラムです。HTTPリクエストを送信できる言語なら利用できます。

はい。リクエスト本文に「webhook_url」を追加すると、完了した生成をそのURLへPOSTします。CheaperGen-Signatureヘッダー（タイムスタンプと生の本文に対するHMAC-SHA256）で署名します。GET /api/v1/generations/{id}でポーリングする方法もあります。

テキストから画像を生成の開始価格は$0.0384 画像1枚あたりです。このページのリクエスト例は$0.039、fal APIの料金より23%安いです。生成に失敗した場合は自動返金されます。