Upscale (agrandir une tuile)

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

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

POST

midjourney

generations

upscale

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

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

Sélectionne l’une des tuiles U1–U4 d’une grille parente (grid_image_url) pour obtenir une image individuelle. Réalisé en découpant à partir des 4 images existantes ; composition locale, généralement instantané.

Item	Valeur
action	`UPSCALE`
Facturation	`midjourney@upscale[-version][-speed]`
Requis	`task_id` + `index`, ou `task_id` + `custom_id`
Optionnel	`speed`, `metadata`

Paramètres

Champ	Type	Description
`task_id`	string	ID de la tâche parente (doit être un imagine / variation / reroll, etc. en SUCCESS)
`index`	int	Quelle image (U1–U4), plage `1`–`4` ; l’un de `index` / `custom_id`
`custom_id`	string	Passez directement l’ID du bouton de l’action correspondante ; l’un de `index` / `custom_id` ; lorsqu’il est défini, le matching par `index` est ignoré
`speed`	string	`relax` / `fast` / `turbo` (sans effet, car composé localement)
`metadata`	object	Métadonnées personnalisées

Exemples de requête

Par index :

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 1,
  "speed": "fast"
}

Passer un bouton directement :

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample::1::xxxx"
}

Réponse

L’envoi renvoie un nouveau task_id, généralement SUCCESS en quelques millisecondes. En cas de SUCCESS, image_urls contient un seul élément (une image), et buttons contient les actions de suivi (zoom / inpaint / pan / variation, etc.).

Notes

La tâche parente doit être en état SUCCESS, sinon elle renvoie 400 (task is not in SUCCESS state).
index doit être 1–4 ; hors plage renvoie 400. custom_id et index sont mutuellement exclusifs ; si les deux sont passés, custom_id l’emporte.
L’étape consommatrice de ressources est imagine ; upscale ne fait que choisir parmi les images existantes et échoue rarement.
L’image individuelle après upscale peut continuer avec Zoom / Inpaint / Variation.

HD upscale (agrandissement haute définition, image 2x individuelle en sortie)

L’upscale ordinaire repose sur une composition locale — il découpe l’une des 4 images déjà présentes dans la tâche parente et renvoie le résultat instantanément. Si vous comptez ensuite effectuer des opérations fines comme zoom / inpaint sur l’image individuelle, il est recommandé d’utiliser plutôt le HD upscale : il réalise un agrandissement réel et produit une image individuelle 2x haute définition, en environ 60–120 s ; l’image obtenue prend en charge de manière plus stable les opérations zoom / inpaint ultérieures. Le HD upscale précise la commande d’agrandissement via custom_id ; chaque version d’imagine correspond à une commande différente :

Commande customId	Version applicable
`upsample_v5_2x`	v5 imagine
`upsample_v5_4x`	v5 imagine
`upsample_v6_2x_subtle`	v6 / v6.1 imagine
`upsample_v6_2x_creative`	v6 / v6.1 imagine
`upsample_v7_2x_subtle`	v7 / v8.1 imagine
`upsample_v7_2x_creative`	v7 / v8.1 imagine

Exemple de HD upscale

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample_v7_2x_subtle::1::xxxx"
}

Une fois terminé, vous obtenez une véritable tâche d’image individuelle 2x haute définition, sur laquelle vous pouvez continuer avec zoom / inpaint.

Comparaison avec l’upscale ordinaire

Dimension	Upscale ordinaire	HD upscale
Implémentation	Composition locale (découpage)	Traitement d’agrandissement réel
Durée	De l’ordre de la milliseconde	Environ 60–120 s
Sortie	La N-ième des 4 images	Image individuelle 2x haute définition
Suite	zoom / inpaint / variation	zoom / inpaint plus stables

⚠️ pan toujours indisponible

Même pour une image individuelle haute définition issue d’un HD upscale, l’opération pan reste refusée (renvoie « requête de génération d’image invalide ») — il s’agit d’une limitation de Midjourney sur l’opération pan elle-même, indépendante de la méthode d’agrandissement. Voir Pan.

Edits (édition d'image)Variation

​Paramètres

​Exemples de requête

​Réponse

​Notes

​HD upscale (agrandissement haute définition, image 2x individuelle en sortie)

​Exemple de HD upscale

​Comparaison avec l’upscale ordinaire

​⚠️ pan toujours indisponible