Upscale (aumentar tile)

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

Seleciona uma das tiles U1–U4 da grid da tarefa pai (grid_image_url) para obter uma imagem individual. Isso é implementado recortando de 4 imagens existentes; composto localmente, geralmente com retorno instantâneo.

Item	Valor
action	`UPSCALE`
Cobrança	`midjourney@upscale[-version][-speed]`
Obrigatório	`task_id` + `index`, ou `task_id` + `custom_id`
Opcional	`speed`, `metadata`

Parâmetros

Campo	Tipo	Descrição
`task_id`	string	ID da tarefa pai (deve ser um imagine / variation / reroll, etc. em SUCCESS)
`index`	int	Qual imagem (U1–U4), faixa `1`–`4`; um de `index` / `custom_id`
`custom_id`	string	Passe diretamente o ID do botão da ação correspondente; um de `index` / `custom_id`; quando definido, o matching por `index` é ignorado
`speed`	string	`relax` / `fast` / `turbo` (sem efeito, pois é composto localmente)
`metadata`	object	Metadados personalizados

Exemplos de requisição

Por index:

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

Passar botão diretamente:

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

Response

O envio retorna um novo task_id, geralmente SUCCESS em milissegundos. Em SUCCESS, image_urls tem um único elemento (uma imagem), e buttons contém ações de acompanhamento (zoom / inpaint / pan / variation, etc.).

Notas

A tarefa pai deve estar em estado SUCCESS, caso contrário retorna 400 (task is not in SUCCESS state).
index deve ser 1–4; fora da faixa retorna 400. custom_id e index são mutuamente exclusivos; se ambos forem passados, custom_id vence.
A etapa que consome recursos é imagine; upscale apenas escolhe de imagens existentes e raramente falha.
A imagem individual após upscale pode continuar com Zoom / Inpaint / Variation.

HD upscale (ampliação em alta definição, saída de imagem única 2x)

O upscale comum é uma composição local — recorta uma das 4 imagens já existentes na tarefa pai e retorna instantaneamente. Se posteriormente você precisar fazer operações refinadas como zoom / inpaint sobre a imagem única, recomenda-se usar o HD upscale: ele executa uma ampliação real, produzindo uma imagem única em alta definição 2x, concluída em cerca de 60–120s, e a imagem única resultante suporta de forma mais estável as operações posteriores de zoom / inpaint. O HD upscale especifica o comando de ampliação por meio do custom_id; versões diferentes de imagine correspondem a comandos diferentes:

Comando customId	Versão aplicável
`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

Exemplo de HD upscale

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

Ao concluir, você obtém uma tarefa de imagem única em alta definição 2x real, sobre a qual pode continuar fazendo zoom / inpaint.

Comparação com o upscale comum

Dimensão	Upscale comum	HD upscale
Implementação	Composição local (recorte)	Processamento de ampliação real
Tempo	Nível de milissegundos	Cerca de 60–120s
Saída	Pega a N-ésima das 4 imagens	Imagem única em alta definição 2x
Posterior	zoom / inpaint / variation	zoom / inpaint mais estáveis

⚠️ pan ainda indisponível

Mesmo a imagem única em alta definição produzida pelo HD upscale, a operação pan ainda será rejeitada (retorna “requisição de geração de imagem inválida”) — esta é uma limitação do próprio Midjourney sobre a operação pan, independente do modo de ampliação. Veja mais em Pan.

Edits (edição de imagem)Variation (variação)

​Parâmetros

​Exemplos de requisição

​Response

​Notas

​HD upscale (ampliação em alta definição, saída de imagem única 2x)

​Exemplo de HD upscale

​Comparação com o upscale comum

​⚠️ pan ainda indisponível