Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
images
/
generations
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.images.create(prompt="A serene mountain landscape at sunset with a lake reflection", model="meetkai:z-image-turbo", n=1, quality="hd", response_format="url", size="1024x1024", style="vivid")

    # Handle response
    print(res)
{
  "created": 1704067200,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "A serene mountain landscape at sunset with a calm lake reflection, digital art style"
    }
  ]
}

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>.

Cuerpo

application/json

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

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:meetkai:z-image-turbo

El modelo a utilizar para la generación de imágenes. Por defecto es 'meetkai:z-image-turbo'.

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:standard

La calidad de la imagen que se generará. 'hd' crea imágenes con detalles más finos y mayor consistencia. Por defecto es 'estándar'.

Opciones disponibles:
standard,
hd
response_format
enum<string>
predeterminado:url

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

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

El tamaño de las imágenes generadas. Debe ser uno de 256x256, 512x512, 1024x1024, 1792x1024 o 1024x1792. Por defecto es 1024x1024.

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

El estilo de las imágenes generadas. 'vivo' hace que el modelo se incline hacia la generación de imágenes hiperralistas y dramáticas. 'natural' hace que el modelo produzca imágenes más naturales, menos hiperralistas. Por defecto, se establece en 'vivo'.

Opciones disponibles:
vivid,
natural
user
string

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

Respuesta

200 - application/json

Está bien

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

created
number
requerido

La marca de tiempo de 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 la imagen generada.