> ## 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 — Generación de imágenes a partir de texto

Ming Image es una familia de modelos de generación de imágenes. `ming-image-0.1-design` permite generar imágenes a partir de texto mediante el protocolo de generación de imágenes de OpenAI.

* `ming-image-0.1-design`: Permite generar imágenes a partir de texto mediante el protocolo de generación de imágenes de OpenAI.
* `ming-image-0.1-design-layer`: Solo permite la separación en capas mediante el protocolo de edición de imágenes de OpenAI (consulta la API de [separación en capas de Ming Image](/es/api-reference/model-apis-ming-image-layer)).

## Encabezados de la solicitud

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer, por ejemplo: Bearer \{\{API Key}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="model" type="enum" required={true}>
  Nombre del modelo. Valores disponibles: `ming-image-0.1-design`
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Descripción textual de la imagen.
</ParamField>

<ParamField body="output_format" type="string" default="png" required={false}>
  Formato de la imagen de salida. Debe ser `png` o `jpeg`.
</ParamField>

<ParamField body="response_format" type="string" default="b64_json" required={false}>
  Formato en el que se devuelve la imagen; el valor predeterminado es `b64_json`. Valores disponibles: `url`, `b64_json`. Nota: `url` tiene una validez de 24 horas.
</ParamField>

<ParamField body="size" type="string" default="auto" required={false}>
  Tamaño de la imagen de salida. El valor predeterminado `auto` lo selecciona automáticamente según el modelo. Formato: `"{w}x{h}"`, por ejemplo, `"1024x1024"`.

  `ming-image-0.1-design` solo admite tamaños de 1k o superiores, por ejemplo, `"1024x1024"`, `"2048x2048"`.
</ParamField>

<ParamField body="watermark" type="boolean" default={false} required={false}>
  Controla si se añade una marca de agua a la imagen generada por IA. `true`: activa la marca de agua visible y la marca de agua digital implícita en las imágenes generadas por IA, conforme a los requisitos de las políticas. `false`: desactiva todas las marcas de agua.
</ParamField>

## Respuesta

<ResponseField name="created" type="integer" required={true}>
  Marca de tiempo Unix (en segundos) del momento en que se creó la respuesta.
</ResponseField>

<ResponseField name="data" type="array" required={true}>
  Array de imágenes devueltas; cada elemento contiene la información de una imagen generada.

  <Expandable title="propiedades">
    <ResponseField name="b64_json" type="string">
      Datos de la imagen generada codificados en base64.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="output_format" type="string" required={true}>
  Formato real de la imagen de salida, por ejemplo, `png`, `jpeg`.
</ResponseField>

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

<ResponseField name="usage" type="object" required={true}>
  Estadísticas de uso de tokens.

  <Expandable title="propiedades">
    <ResponseField name="input_tokens" type="integer">
      Total de tokens de entrada (0 para la generación de imágenes a partir de texto).
    </ResponseField>

    <ResponseField name="input_tokens_details" type="object">
      Detalles de los tokens de entrada.

      <Expandable title="propiedades">
        <ResponseField name="image_tokens" type="integer">
          Número de tokens de imagen en la entrada (0 para la generación de imágenes a partir de texto).
        </ResponseField>

        <ResponseField name="text_tokens" type="integer">
          Número de tokens de texto en la entrada.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="output_tokens" type="integer">
      Total de tokens de salida (es decir, los tokens consumidos por la imagen generada).
    </ResponseField>

    <ResponseField name="total_tokens" type="integer">
      Suma de los tokens de entrada y salida.
    </ResponseField>

    <ResponseField name="output_tokens_details" type="object">
      Detalles de los tokens de salida.

      <Expandable title="propiedades">
        <ResponseField name="image_tokens" type="integer">
          Número de tokens de imagen en la salida.
        </ResponseField>

        <ResponseField name="text_tokens" type="integer">
          Número de tokens de texto en la salida.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="model" type="string" required={true}>
  Nombre del modelo que procesó realmente la solicitud.
</ResponseField>

<ResponseField name="id" type="string" required={true}>
  Identificador único de esta solicitud.
</ResponseField>

## Ejemplo

`Solicitud:`

```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"
}'
```

`Respuesta:`

```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"
}
```