Pular para o conteúdo 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"
    }
  ]
}

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

Corpo

application/json

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

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

O modelo a ser utilizado para geração de imagens. Padrão 'meetkai:z-image-turbo'.

n
integer
padrão:1

O número de imagens a ser gerado. Deve estar entre 1 e 10. 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. 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 tenda a gerar imagens hiperralistas e dramáticas. 'natural' faz com que o modelo produza imagens mais naturais, com aparência menos hiperralista. O padrão é 'vivo'.

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

Um identificador único representando seu usuário final, que pode ajudar a monitorar e detectar abusos.

Resposta

200 - application/json

OK

Resposta do ponto de extremidade de geração de imagens contendo as imagens geradas e os 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.