> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ming Image — テキストから画像を生成

Ming Image は画像生成モデルのファミリーです。`ming-image-0.1-design` は、OpenAI の画像生成プロトコルを使用したテキストからの画像生成に対応しています。

* `ming-image-0.1-design`: OpenAI の画像生成プロトコルを使用したテキストからの画像生成に対応しています。
* `ming-image-0.1-design-layer`: OpenAI の画像編集プロトコルを使用したレイヤー分離のみに対応しています（[Ming Image レイヤー分離](/ja/api-reference/model-apis-ming-image-layer) API を参照）。

## リクエストヘッダー

<ParamField header="Content-Type" type="string" required={true}>
  対応形式: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証の形式。例: Bearer \{\{API Key}}。
</ParamField>

## リクエストボディ

<ParamField body="model" type="enum" required={true}>
  モデル名。指定可能な値: `ming-image-0.1-design`
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  画像の内容を表すテキスト。
</ParamField>

<ParamField body="output_format" type="string" default="png" required={false}>
  出力画像の形式。`png` または `jpeg` を指定する必要があります。
</ParamField>

<ParamField body="response_format" type="string" default="b64_json" required={false}>
  画像の返却形式。デフォルトは `b64_json` です。指定可能な値: `url`、`b64_json`。注意: `url` の有効期間は 24 時間です。
</ParamField>

<ParamField body="size" type="string" default="auto" required={false}>
  出力画像のサイズ。デフォルトの `auto` では、モデルに基づいて自動的に選択されます。形式: `"{w}x{h}"`。例: `"1024x1024"`。

  `ming-image-0.1-design` は 1k 以上のサイズのみに対応しています。例: `"1024x1024"`、`"2048x2048"`。
</ParamField>

<ParamField body="watermark" type="boolean" default={false} required={false}>
  AI 生成画像にウォーターマークを追加するかどうかを指定します。`true`: ポリシー要件に準拠し、AI 生成画像の可視ウォーターマークと不可視のデジタルウォーターマークを有効にします。`false`: すべてのウォーターマークを無効にします。
</ParamField>

## レスポンス

<ResponseField name="created" type="integer" required={true}>
  レスポンスが作成された時点の Unix タイムスタンプ（秒）。
</ResponseField>

<ResponseField name="data" type="array" required={true}>
  返却される画像の配列。各要素には、生成された画像 1 枚の情報が含まれます。

  <Expandable title="プロパティ">
    <ResponseField name="b64_json" type="string">
      base64 でエンコードされた生成画像のデータ。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="output_format" type="string" required={true}>
  実際の出力画像形式。例: `png`、`jpeg`。
</ResponseField>

<ResponseField name="size" type="string">
  `null`
</ResponseField>

<ResponseField name="usage" type="object" required={true}>
  トークン使用量の統計。

  <Expandable title="プロパティ">
    <ResponseField name="input_tokens" type="integer">
      入力トークンの合計数（テキストからの画像生成では 0）。
    </ResponseField>

    <ResponseField name="input_tokens_details" type="object">
      入力トークンの詳細。

      <Expandable title="プロパティ">
        <ResponseField name="image_tokens" type="integer">
          入力に含まれる画像トークン数（テキストからの画像生成では 0）。
        </ResponseField>

        <ResponseField name="text_tokens" type="integer">
          入力に含まれるテキストトークン数。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="output_tokens" type="integer">
      出力トークンの合計数（生成画像が消費したトークン数）。
    </ResponseField>

    <ResponseField name="total_tokens" type="integer">
      入力トークン数と出力トークン数の合計。
    </ResponseField>

    <ResponseField name="output_tokens_details" type="object">
      出力トークンの詳細。

      <Expandable title="プロパティ">
        <ResponseField name="image_tokens" type="integer">
          出力に含まれる画像トークン数。
        </ResponseField>

        <ResponseField name="text_tokens" type="integer">
          出力に含まれるテキストトークン数。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="model" type="string" required={true}>
  実際にリクエストを処理したモデルの名前。
</ResponseField>

<ResponseField name="id" type="string" required={true}>
  このリクエストの一意の識別子。
</ResponseField>

## 使用例

`リクエスト:`

```bash theme={"system"}
curl --location --request POST 'https://api.novita.ai/v1/images/generations' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'content-type: application/json' \
--data-raw '{
  "model": "ming-image-0.1-design",
  "prompt": "Generate a banana"
}'
```

`レスポンス:`

```js theme={"system"}
{
  "created": 1789642354,
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "output_format": "png",
  "size": null,
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    },
    "output_tokens": 16384,
    "total_tokens": 16384,
    "output_tokens_details": {
      "image_tokens": 16384,
      "text_tokens": 0
    }
  },
  "model": "Ming-Image-0.1-Design-StressTest",
  "id": "2180534417896423312485570e8523"
}
```