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"
}
}
Z-Image-Turbo
Geração de Imagens Z-Image-Turbo
- Modo de processamento assíncrono, retorna um ID de tarefa para consultas posteriores
- Geração de imagens leve e rápida, com suporte a chinês e inglês
- Suporta os níveis de resolução 1K/2K, com reescrita inteligente de prompts
POST
/
v1
/
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
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
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
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
true: verificar prompts e imagens de entrada comomni-moderation-latestfalseou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para a geração da imagem, até 800 caracteres
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
1:1- Quadrado (padrão)4:3- Paisagem 4:33:4- Retrato 3:416:9- Paisagem widescreen9:16- Retrato vertical3:2- Paisagem 3:22:3- Retrato 2:3
string
padrão:"1K"
Nível de resolução
1K- Resolução padrão (padrão)2K- Resolução de alta definição
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çãosize (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"
}
{
"model": "z-image-turbo",
"prompt": "Minimalist style cafe interior design",
"size": "16:9",
"resolution": "2K"
}
{
"model": "z-image-turbo",
"prompt": "A cat",
"prompt_extend": true
}
Resposta
integer
Código de status da resposta
array
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
nnão é suportado