テキストから画像生成

テキストから画像を生成します。長文プロンプトや画像内の文字描画に対応し、ポスターやイラストなどの制作に活用できます。

1. APIキーを作成

   APIキー管理プラットフォームにアクセスしてAPIキーを作成し、環境変数として保存してください。APIキーをクライアントコードに書き込んだり、リポジトリにコミットしたりしないでください。

   export MOSS_API_KEY='YOUR_API_KEY'

2. リクエスト入力を準備

   プロンプト、画像サイズ、モデルIDを指定します。1回のリクエストで生成できる画像は1枚です。ストリーミング出力には対応していません。

   フィールド型必須説明

   model: string必須

   モデルIDです。安定版のmodel IDの使用を推奨します。固定バージョンを再現する必要がある場合は、スナップショットモデルIDを指定できます。

   指定可能な値を表示（4件）

   "moss-image-base-1.0"

   安定版のmodel IDです。

   "moss-image-base-1.0-2026-10-09"

   モデルバージョンを固定するためのSnapshot model IDです。

   "moss-image-sft-1.0"

   安定版のmodel ID（SFT版）です。

   "moss-image-sft-1.0-2026-10-09"

   モデルバージョンを固定するためのSnapshot model ID（SFT版）です。

   prompt: string必須

   生成したい画像を説明するプロンプトです。1〜4,000文字で入力してください。「レイアウトから画像生成」で、テキストやオブジェクトの位置・サイズ・配置を指定できます。

   size: string任意

   画像サイズを「幅x高さ」で指定します。幅・高さはそれぞれ256〜2048ピクセルの範囲で、16の倍数にしてください。総画素数は2,097,152ピクセル以下です。

   n: integer任意

   生成する画像の枚数です。1のみに対応しています。

   response_format: string任意

   urlのみに対応しており、b64_jsonには対応していません。

   output_watermark: object任意

   生成画像の透かし設定。enabledには真偽値を指定します。省略すると、画像に透かしが表示されます。{"enabled": false}を指定すると透かしは非表示になります。

   {
     "model": "moss-image-sft-1.0",
     "prompt": "窓辺に座る茶トラの猫、窓の外には雨上がりの庭、やわらかな自然光、温かく繊細な写真スタイル。",
     "negative_prompt": "nsfw, worst quality, bad anatomy, watermark, jpeg artifact",
     "size": "1024x1024",
     "n": 1,
     "response_format": "url",
     "output_watermark": {"enabled": true}
   }

3. 画像生成リクエストを送信

   /v1/images/generationsにリクエストを送信します。生成が完了すると、APIはJSONを返します。

   curl --max-time 900 -X POST "https://api.mosi.cn/v1/images/generations" \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "model": "moss-image-sft-1.0",
     "prompt": "窓辺に座る茶トラの猫、窓の外には雨上がりの庭、やわらかな自然光、温かく繊細な写真スタイル。",
     "negative_prompt": "nsfw, worst quality, bad anatomy, watermark, jpeg artifact",
     "size": "1024x1024",
     "n": 1,
     "response_format": "url",
     "output_watermark": {"enabled": true}
   }'

   import os
   import requests
   
   resp = requests.post(
       "https://api.mosi.cn/v1/images/generations",
       headers={
           "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
           "Content-Type": "application/json",
       },
       timeout=900,
       json={
           "model": "moss-image-sft-1.0",
           "prompt": "窓辺に座る茶トラの猫、窓の外には雨上がりの庭、やわらかな自然光、温かく繊細な写真スタイル。",
           "negative_prompt": "nsfw, worst quality, bad anatomy, watermark, jpeg artifact",
           "size": "1024x1024",
           "n": 1,
           "response_format": "url",
           "output_watermark": {"enabled": True}
       },
   )
   
   print(resp.status_code)
   print(resp.json())

   const response = await fetch("https://api.mosi.cn/v1/images/generations", {
     method: "POST",
     signal: AbortSignal.timeout(900_000),
     headers: {
       Authorization: `Bearer ${process.env.MOSS_API_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
       "model": "moss-image-sft-1.0",
       "prompt": "窓辺に座る茶トラの猫、窓の外には雨上がりの庭、やわらかな自然光、温かく繊細な写真スタイル。",
       "negative_prompt": "nsfw, worst quality, bad anatomy, watermark, jpeg artifact",
       "size": "1024x1024",
       "n": 1,
       "response_format": "url",
       "output_watermark": {"enabled": true}
     }),
   });
   
   console.log(response.status);
   console.log(await response.json());

   サンプルのタイムアウトは900秒ですが、固定のサーバー側タイムアウトを表すものではありません。

4. 生成した画像を取得

   生成に成功すると、レスポンスのdata[0].urlに画像のURLが返されます。URLにアクセスして、PNG画像を表示またはダウンロードできます。usage.generated_images、usage.output_width、usage.output_heightは、それぞれ実際に生成された枚数、画像の幅、画像の高さを表します。

   # Replace the example URL with data[0].url
   curl --fail --location "https://example.com/generated-image.png" \
     --output image.png

   import requests
   
   # Replace the example URL with data[0].url
   image_url = "https://example.com/generated-image.png"
   resp = requests.get(image_url)
   resp.raise_for_status()
   
   with open("image.png", "wb") as file:
       file.write(resp.content)
   
   print("Image saved to image.png")

   import { writeFile } from "node:fs/promises";
   
   // Replace the example URL with data[0].url
   const imageUrl = "https://example.com/generated-image.png";
   const response = await fetch(imageUrl);
   if (!response.ok) {
     throw new Error(`Download failed: ${response.status}`);
   }
   
   await writeFile("image.png", Buffer.from(await response.arrayBuffer()));
   console.log("Image saved to image.png");

5. 生成結果を確認

   取得したURLからPNG画像を表示またはダウンロードできれば、生成は成功です。

次のステップ