Generación de imágenes 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 admitidos

Modelo	Descripción	Imágenes por solicitud	Precio
`z-image-turbo`	Generación de imágenes ligera y rápida, compatible con chino e inglés	1 imagen fija	Precio fijo

Autorización

string

requerido

Todos los endpoints requieren autenticación mediante Bearer TokenObtener la clave de API:Visite Gestión de claves de API para obtener su clave de APIAñádala a la cabecera de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo de la solicitud

string

requerido

Nombre del modelo

z-image-turbo - Generación de imágenes ligera y rápida, compatible con chino e inglés

boolean

predeterminado:"false"

Indica si se debe moderar el contenido antes de enviar la tarea de imagen.

true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)

string

requerido

Descripción textual para la generación de la imagen, hasta 800 caracteres

string

predeterminado:"1:1"

Proporción de la imagenProporciones admitidas:

1:1 - Cuadrado (predeterminado)
4:3 - Horizontal 4:3
3:4 - Vertical 3:4
16:9 - Panorámico horizontal
9:16 - Vertical alargado
3:2 - Horizontal 3:2
2:3 - Vertical 2:3

string

predeterminado:"1K"

Nivel de resolución

1K - Resolución estándar (predeterminada)
2K - Resolución de alta definición

boolean

predeterminado:"false"

Reescritura inteligente del promptCuando está activada, la IA optimiza automáticamente el prompt para obtener mejores resultados, lo que aumenta los costes.

false - Desactivada (predeterminada)
true - Activada

Tabla de referencia de resoluciones

El tamaño de salida se controla mediante la combinación de size (proporción) + resolution (nivel de resolución).

Proporción	Nivel 1K	Nivel 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

Ejemplos de uso

Text-to-Image básico (solicitud mínima)

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

Especificar proporción y resolución

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

Activar la reescritura inteligente del prompt

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

Respuesta

integer

Código de estado de la respuesta

array

Array de datos de la respuesta

Mostrar Propiedades

string

Estado de la tarea

submitted - Enviada

string

Identificador único de la tarea

Notas

Procesamiento asíncrono: tras el envío se devuelve un task_id. Consulte /v1/tasks/{task_id} para obtener los resultados
Almacenamiento de imágenes: las imágenes generadas se replican en la CDN de la plataforma y son válidas a largo plazo
Reglas de facturación: se factura por cada imagen generada correctamente; no se cobran los fallos
Cantidad fija: Z-Image-Turbo genera exactamente 1 imagen por solicitud; el parámetro n no está admitido

Visión general

Modelos

Serie de texto

Serie de imágenes

Serie de video

Serie de audio

Serie de Moderación

Gestión de subidas

Gestión de tareas

Gestión de cuenta

Generación de imágenes Z-Image-Turbo

Modelos admitidos

Autorización

Cuerpo de la solicitud

Tabla de referencia de resoluciones

Ejemplos de uso

Respuesta

Notas

​Modelos admitidos

​Autorización

​Cuerpo de la solicitud

​Tabla de referencia de resoluciones

​Ejemplos de uso

​Respuesta

​Notas

Modelos admitidos

Autorización

Cuerpo de la solicitud

Tabla de referencia de resoluciones

Ejemplos de uso

Respuesta

Notas