Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
images
/
generations
Python (SDK)
from mka1 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="auto", 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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

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.