Saltar al contenido principal
POST
/
v1
/
midjourney
/
generations
/
variation
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/variation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 3,
    "speed": "turbo"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/variation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 3,
    "speed": "turbo"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Crea una variación sutil (varySubtle, equivalente a V1–V4) a partir de una baldosa de una cuadrícula Imagine. Para una variación fuerte, vea High Variation.
ItemValor
actionVARIATION
Facturaciónmidjourney@variation[-speed]
Requeridotask_id + index, o task_id + custom_id
Opcionalspeed, metadata

Parámetros

CampoDescripción
task_idID de tarea original devuelto por esta plataforma (debe ser SUCCESS)
index14, mapea a V1V4; uno de index / custom_id
custom_idID del botón de la acción correspondiente; cuando se establece, omite el matching por index
speedrelax / fast / turbo
metadataMetadatos personalizados

Ejemplo de solicitud

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 3,
  "speed": "turbo"
}

Respuesta

El envío devuelve una nueva task_id local. Sondee GET /v1/tasks/{task_id}; al tener SUCCESS el resultado incluye una nueva cuadrícula grid_image_url más cuatro image_urls:
{
  "id": "task_xxx",
  "status": "SUCCESS",
  "action": "VARIATION",
  "grid_image_url": "...",
  "image_urls": ["...", "...", "...", "..."]
}
version / niji de la tarea origen se heredan automáticamente (afecta el fallback de facturación). Para precios por speed, configure midjourney@variation-fast / midjourney@variation-turbo.

Notas

  • La tarea padre debe estar en estado SUCCESS, de lo contrario devuelve 400 (task is not in SUCCESS state).
  • index debe ser 14; custom_id e index son mutuamente excluyentes.
  • Por defecto usa varySubtle (variación sutil); para una variación fuerte use High Variation; Low Variation es la misma action con una clave de facturación distinta y comportamiento idéntico.