Pular para o conteúdo 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.

Autorizações

​
Authorization
string
header
obrigatório

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

Cabeçalhos

​
X-On-Behalf-Of
string

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

Corpo

application/json

Parâmetros de solicitação para gerar imagens. Cria uma ou mais imagens a partir de um texto de entrada.

​
prompt
string
obrigatório

Uma descrição em texto da(s) imagem(ns) desejada(s). O comprimento máximo é de 1000 caracteres.

Required string length: 1 - 1000
​
model
string
padrão:auto

O modelo a ser utilizado para geração de imagens. O padrão é 'auto'.

​
n
integer
padrão:1

O número de imagens a gerar. Deve estar entre 1 e 10. O padrão é 1.

Intervalo obrigatório: 1 <= x <= 10
​
quality
enum<string>
padrão:standard

A qualidade da imagem que será gerada. 'hd' cria imagens com detalhes mais finos e maior consistência. Padrão 'standard'.

Opções disponíveis:
standard,
hd
​
response_format
enum<string>
padrão:url

O formato em que as imagens geradas são retornadas. 'url' retorna uma URL para a imagem, 'b64_json' retorna a imagem como uma string JSON codificada em base64. O padrão é 'url'.

Opções disponíveis:
url,
b64_json
​
size
enum<string>
padrão:1024x1024

O tamanho das imagens geradas. Deve ser um dos seguintes: 256x256, 512x512, 1024x1024, 1792x1024 ou 1024x1792. O padrão é 1024x1024.

Opções disponíveis:
256x256,
512x512,
1024x1024,
1792x1024,
1024x1792
​
style
enum<string>
padrão:vivid

O estilo das imagens geradas. 'vivo' faz com que o modelo incline-se a gerar imagens hiper-reais e dramáticas. 'natural' faz com que o modelo produza imagens mais naturais, com aparência menos hiper-real. Padrão é 'vivo'.

Opções disponíveis:
vivid,
natural
​
user
string

Um identificador exclusivo que representa seu usuário final, o que pode ajudar a monitorar e detectar abusos.

Resposta

200 - application/json

OK

Resposta do ponto final de geração de imagens contendo as imagens geradas e metadados.

​
created
number
obrigatório

O timestamp Unix (em segundos) de quando a geração da imagem foi concluída.

​
data
object[]
obrigatório

Uma lista de objetos de imagem contendo os dados da imagem gerada.