Geração de Imagens Z-Image-Turbo

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

Modelos suportados

Modelo	Descrição	Imagens por requisição	Preço
`z-image-turbo`	Geração de imagens leve e rápida, com suporte a chinês e inglês	Fixo em 1 imagem	Preço fixo

Autorização

Authorization

string

obrigatório

Todos os endpoints exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse o gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Authorization: Bearer YOUR_API_KEY

Corpo da requisição

model

string

obrigatório

Nome do modelo

z-image-turbo - Geração de imagens leve e rápida, com suporte a chinês e inglês

prompt

string

obrigatório

Descrição textual para a geração da imagem, até 800 caracteres

size

string

padrão:"1:1"

Proporção da imagemProporções suportadas:

1:1 - Quadrado (padrão)
4:3 - Paisagem 4:3
3:4 - Retrato 3:4
16:9 - Paisagem widescreen
9:16 - Retrato vertical
3:2 - Paisagem 3:2
2:3 - Retrato 2:3

resolution

string

padrão:"1K"

Nível de resolução

1K - Resolução padrão (padrão)
2K - Resolução de alta definição

prompt_extend

boolean

padrão:"false"

Reescrita inteligente de promptsQuando ativada, a IA otimizará automaticamente o prompt para obter melhores resultados, e os custos aumentarão.

false - Desativada (padrão)
true - Ativada

Tabela de referência de resoluções

O tamanho da saída é controlado pela combinação size (proporção) + resolution (nível de resolução).

Proporção	Nível 1K	Nível 2K
`1:1`	1024×1024	2048×2048
`4:3`	1152×864	2048×1536
`3:4`	864×1152	1536×2048
`16:9`	1280×720	2048×1152
`9:16`	720×1280	1152×2048
`3:2`	1248×832	2048×1360
`2:3`	832×1248	1360×2048

Exemplos de uso

Text-to-Image básico (requisição mínima)

{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}

Especificar proporção e resolução

{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}

Ativar reescrita inteligente de prompts

{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}

Resposta

code

integer

Código de status da resposta

data

array

Array de dados da resposta

Mostrar Propriedades

status

string

Status da tarefa

submitted - Enviada

task_id

string

Identificador único da tarefa

Observações

Processamento assíncrono: após o envio, um task_id é retornado. Consulte /v1/tasks/{task_id} para obter os resultados
Armazenamento de imagens: as imagens geradas são espelhadas no CDN da plataforma e ficam válidas por longo prazo
Regras de cobrança: cobrado por imagem gerada com sucesso, sem cobrança em caso de falha
Quantidade fixa: o Z-Image-Turbo gera exatamente 1 imagem por requisição; o parâmetro n não é suportado

Geração de Imagens Qwen Image 2.0 Geração de Imagens Grok Imagine 1.5

​Modelos suportados

​Autorização

​Corpo da requisição

​Tabela de referência de resoluções

​Exemplos de uso

​Resposta

​Observações

Modelos suportados

Autorização

Corpo da requisição

Tabela de referência de resoluções

Exemplos de uso

Resposta

Observações