Saltar al contenido principal
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"
  }'

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

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

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"
  }'

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

​
Modelos admitidos

ModeloDescripciónImágenes por solicitudPrecio
z-image-turboGeneración de imágenes ligera y rápida, compatible con chino e inglés1 imagen fijaPrecio fijo

​
Autorización

​
Authorization
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

​
model
string
requerido
Nombre del modelo
  • z-image-turbo - Generación de imágenes ligera y rápida, compatible con chino e inglés
​
prompt
string
requerido
Descripción textual para la generación de la imagen, hasta 800 caracteres
​
size
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
​
resolution
string
predeterminado:"1K"
Nivel de resolución
  • 1K - Resolución estándar (predeterminada)
  • 2K - Resolución de alta definición
​
prompt_extend
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ónNivel 1KNivel 2K
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×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

​
code
integer
Código de estado de la respuesta
​
data
array
Array de datos de la respuesta

​
Notas

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