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": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

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": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

​
Autorización

​
Authorization
string
requerido
Todas las solicitudes requieren autenticación mediante Bearer Token.Visite la página de gestión de claves de API para obtener su clave de API y, a continuación, añádala a la cabecera de la solicitud:
Authorization: Bearer YOUR_API_KEY

​
Modelos disponibles

ModeloDescripciónResolución máx. (Text-to-Image)Resolución máx. (Edición / Secuencial)Precio
wan2.7-image-proEdición profesional, mejores detalles, admite 4K4K2K¥0,50 / imagen
wan2.7-imageEdición estándar, generación más rápida2K2K¥0,20 / imagen
La facturación se basa en imágenes generadas correctamente × precio unitario. La entrada no se factura. La resolución y la proporción no afectan al precio. Las solicitudes fallidas no se cobran.

​
Cuerpo de la solicitud

​
model
string
requerido
Nombre del modelo de generación de imágenes.
  • wan2.7-image-pro — Edición profesional, hasta 4K en text-to-image
  • wan2.7-image — Edición estándar, más rápida, hasta 2K
​
prompt
string
Descripción textual para la generación de la imagen, hasta 5000 caracteres.
  • Text-to-image (sin image_urls): obligatorio
  • Edición de imágenes (con image_urls): opcional pero recomendado
Ejemplo: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
​
image_urls
array<string>
Array de URL de imágenes de entrada para escenarios de edición y referencia con múltiples imágenes.Al proporcionar este campo, la solicitud pasa al modo de edición de imágenes.Formatos admitidos: URL HTTP/HTTPS; Base64 data:image/...;base64,...Restricciones: hasta 9 imágenes; JPEG / PNG / WEBP / BMP; 240–8000 px, proporción 1:8 ~ 8:1; ≤ 20MB por imagen
La proporción de salida coincide automáticamente con la última imagen de entrada. El modo de edición admite solo hasta 2K; 4K no está disponible.
​
n
integer
predeterminado:"1"
Número de imágenes a generar.
  • Modo estándar: 1–4 (predeterminado 1)
  • Modo secuencial (enable_sequential: true): 1–12 (predeterminado 1)
Se factura por cada imagen generada correctamente. Se precobra según n.
​
size
string
Resolución de salida o proporción. Admite tres formatos:① Palabra clave de resolución (recomendado): 1K / 2K (predeterminado) / 4K (solo para wan2.7-image-pro text-to-image)② Proporción: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (utiliza el nivel 2K por defecto)③ Dimensiones en píxeles: 1024x1024 o 1024*1024
​
resolution
string
Palabra clave del nivel de resolución: 1K / 2K / 4K. Se puede combinar con size (proporción).
ModeloEscenarioNiveles admitidosRango de píxeles
wan2.7-image-proText-to-image (no secuencial)1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-proEdición / secuencial1K / 2K768×768 ~ 2048×2048
wan2.7-imageTodos los escenarios1K / 2K768×768 ~ 2048×2048
​
negative_prompt
string
Prompt negativo que describe los elementos que se deben evitar. Ejemplo: "blurry, distorted, low quality"
​
watermark
boolean
predeterminado:"false"
Indica si debe añadirse una marca de agua “AI Generated” en la esquina inferior derecha.
​
seed
integer
Semilla aleatoria, rango 0–2147483647. La misma semilla con parámetros idénticos produce resultados visualmente consistentes.
​
thinking_mode
boolean
predeterminado:"true"
Activa el modo de razonamiento mejorado para mejorar la calidad de la imagen a costa de un mayor tiempo de generación.
Solo es efectivo cuando el modo secuencial está desactivado y no se proporciona ninguna imagen de entrada.
​
enable_sequential
boolean
predeterminado:"false"
Activa el modo de generación secuencial de imágenes: genera múltiples imágenes coherentes temáticamente en una sola solicitud. Ideal para storyboards y series.
  • n máximo es 12 cuando está activado
  • thinking_mode y color_palette se ignoran en modo secuencial
  • wan2.7-image-pro admite hasta 2K en modo secuencial (no se admite 4K)
​
bbox_list
array
Cuadros delimitadores para edición interactiva: especifica las regiones exactas que se van a editar o donde se va a insertar contenido.Estructura: [[[x1, y1, x2, y2], ...], ...]
  • La longitud del array externo debe coincidir con la de image_urls
  • Pase [] para las imágenes sin cuadro delimitador
  • Máximo 2 cuadros por imagen; las coordenadas son valores absolutos en píxeles, con origen (0,0) en la esquina superior izquierda
Ejemplo: [[], [[989, 515, 1138, 681]]]
​
color_palette
array<object>
Paleta de colores personalizada. Solo en modo estándar (no en modo secuencial).
  • 3–10 entradas (se recomiendan 8); cada entrada requiere hex y ratio
  • Todos los valores de ratio deben sumar exactamente 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

​
Respuesta

​
code
string
Estado de la respuesta. Devuelve "success" en caso de éxito.
​
data
array

​
Ejemplos

​
Texto a imagen (mínimo)

{
  "model": "wan2.7-image-pro",
  "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

​
Texto a imagen (con resolución)

{
  "model": "wan2.7-image-pro",
  "prompt": "Summer beach, blue sky and white clouds, 4K ultra HD",
  "size": "4K",
  "thinking_mode": true
}

​
Texto a imagen (paleta de colores personalizada)

{
  "model": "wan2.7-image-pro",
  "prompt": "Minimalist modern living room",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

​
Generación secuencial de imágenes

{
  "model": "wan2.7-image-pro",
  "prompt": "Cinematic series: the same stray orange cat, consistent features. First: under cherry blossoms in spring. Second: old street shade in summer. Third: fallen leaves in autumn. Fourth: snow footprints in winter.",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

​
Edición de una sola imagen

{
  "model": "wan2.7-image",
  "prompt": "Replace the background with a sunset scene, warm color tones",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

​
Referencia con múltiples imágenes / fusión de elementos

{
  "model": "wan2.7-image-pro",
  "prompt": "Apply the graffiti from image 2 onto the car in image 1",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

​
Edición interactiva (cuadro delimitador)

bbox_list se corresponde uno a uno con image_urls. Pase [] para las imágenes sin selección. 
{
  "model": "wan2.7-image-pro",
  "prompt": "Place the alarm clock from image 1 into the selected area of image 2, blending naturally",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
Consulta de resultadosLa generación de imágenes es asíncrona. Consulte el endpoint Estado de la tarea utilizando el task_id devuelto hasta que status == completed.