Saltar al contenido principal
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Cuerpo

application/json

Parámetros de solicitud para generar imágenes. Crea una o más imágenes a partir de un aviso de texto.

prompt
string
requerido

Una descripción textual de la(s) imagen(es) deseada(s). La longitud máxima es de 1000 caracteres.

Required string length: 1 - 1000
model
string
predeterminado:auto

El modelo a utilizar para la generación de imágenes. Por defecto es 'auto'.

n
integer
predeterminado:1

El número de imágenes a generar. Debe estar entre 1 y 10. Por defecto es 1.

Rango requerido: 1 <= x <= 10
quality
enum<string>
predeterminado:auto

El nivel de calidad de la imagen generada. Niveles más altos pueden incurrir en mayor latencia o costo. 'auto' permite que la puerta de enlace elija un valor razonable por modelo. 'standard' y 'hd' son aceptados como alias heredados.

Opciones disponibles:
low,
medium,
high,
auto,
standard,
hd
response_format
enum<string>
predeterminado:url

El formato en el que se devuelven las imágenes generadas. 'url' devuelve una URL a la imagen, 'b64_json' devuelve la imagen como una cadena JSON codificada en base64. Por defecto es 'url'.

Opciones disponibles:
url,
b64_json
size
enum<string>
predeterminado:1024x1024

El tamaño de la imagen generada. 'auto' se refiere al valor predeterminado del modelo.

Opciones disponibles:
256x256,
512x512,
1024x1024,
1024x1536,
1536x1024,
1792x1024,
1024x1792,
auto
style
enum<string>
predeterminado:vivid

El estilo de la imagen generada. 'vivid' se inclina hacia lo hiperrealista y dramático. 'natural' produce resultados más naturalistas. Soportado condicionalmente.

Opciones disponibles:
vivid,
natural
output_format
enum<string>

Formato de archivo de salida. Soportado condicionalmente.

Opciones disponibles:
png,
webp,
jpeg
user
string

Un identificador único que representa a su usuario final, lo cual puede ayudar a monitorear y detectar abusos.

Respuesta

200 - application/json

Está bien

Respuesta del punto final de generación de imágenes que contiene las imágenes generadas y los metadatos.

created
number
requerido

La marca de tiempo Unix (en segundos) de cuando se completó la generación de la imagen.

data
object[]
requerido

Una lista de objetos de imagen que contienen los datos de imagen generados.