Saltar para o conteúdo principal
Base URL: https://api.apimart.aiAuth: Authorization: Bearer <token>As novas rotas /v1/midjourney/... injetam model=midjourney automaticamente; você não precisa passar model no body.

​
Início rápido

# 1. Enviar tarefa Imagine
curl -X POST https://api.apimart.ai/v1/midjourney/generations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'

# 2. Pollar a API unificada de tarefas até status=completed
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
  -H "Authorization: Bearer <token>"

# 3. Aumentar a imagem 1
curl -X POST https://api.apimart.ai/v1/midjourney/generations/upscale \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task_01JWXXXX", "index": 1}'

​
Visão geral da API

Os campos completos, exemplos e notas de cada recurso estão na subpágina correspondente.
RecursoCaminhoDocumentação
Texto para imagem (entrada padrão)POST /v1/midjourney/generationsImagine
Texto para imagem (entrada explícita)POST /v1/midjourney/generations/imagineImagine
Mistura de múltiplas imagensPOST /v1/midjourney/generations/blendBlend
Imagem para textoPOST /v1/midjourney/generations/describeDescribe
Edição de imagemPOST /v1/midjourney/generations/editsEdits
Aumentar uma tilePOST /v1/midjourney/generations/upscaleUpscale
VariaçãoPOST /v1/midjourney/generations/variationVariation
Variação fortePOST /v1/midjourney/generations/high-variationHigh Variation
Variação sutilPOST /v1/midjourney/generations/low-variationLow Variation
RegenerarPOST /v1/midjourney/generations/rerollReroll
Zoom outPOST /v1/midjourney/generations/zoomZoom
PanPOST /v1/midjourney/generations/panPan
InpaintPOST /v1/midjourney/generations/inpaintInpaint
Modal (parâmetros)POST /v1/midjourney/generations/modalModal
Imagem para vídeoPOST /v1/midjourney/generations/videoVideo
Remix (forte / sutil)POST /v1/midjourney/generations/remix-strong · /remix-subtleRemix
Consulta de tarefaGET /v1/tasks/{task_id} · /v1/midjourney/{task_id}Consultar tarefa
Veja também: Boas práticas (polling / retentativas / solução de problemas) · Fluxos ponta a ponta (tutoriais curl + wrappers de cliente)

​
Fluxo de ponta a ponta

​
Erros

​
Formato de response de erro

{
  "error": {
    "type": "invalid_request_error",
    "message": "prompt is required"
  }
}

​
Erros comuns

HTTPtypeSignificado
400invalid_request_errorParâmetros inválidos
401authentication_errorAPI key inválida
402payment_requiredSaldo insuficiente
404not_foundTarefa não encontrada
429rate_limit_errorRate limit excedido
500internal_errorErro do servidor

​
Falhas de tarefa

Valores comuns de fail_reason:
  • Banned prompt detected — conteúdo proibido no prompt
  • Task timeout — timeout (reembolso auto após 30+ minutos)
  • No available upstream — serviço temporariamente indisponível, tente novamente

​
Cobrança

O nome unificado do modelo para as novas rotas MJ é midjourney. As keys de cobrança são geradas a partir de action, version e speed. A ordem de match habitual: 
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
ActionNome de cobrançaNotas
Imaginemidjourney@imagine[-version][-speed]Texto para imagem / guiado por imagem
Blendmidjourney@blend[-speed]Mistura multi-imagens
Describemidjourney@describe[-speed]Imagem para texto
Editsmidjourney@edits[-speed]Edição de imagem
Upscalemidjourney@upscale[-version][-speed]Aumentar
Variationmidjourney@variation[-version][-speed]Variação
High Variationmidjourney@high_variation[-version][-speed]Variação forte
Low Variationmidjourney@low_variation[-version][-speed]Variação sutil
Rerollmidjourney@reroll[-version][-speed]Regeneração
Zoommidjourney@zoom[-version][-speed]Zoom out / outpaint
Panmidjourney@pan[-version][-speed]Pan outpaint
Inpaintmidjourney@inpaint[-version][-speed]Entrada inpaint
Modalmidjourney@modal[-speed]Parâmetros de acompanhamento inpaint
Videomidjourney@video / midjourney@video-720pImagem para vídeo, cobrado × batch_size
Remix Strongmidjourney@remix_strong[-speed]Reshape forte (apenas v8.1 / v8.2)
Remix Subtlemidjourney@remix_subtle[-speed]Reshape sutil (apenas v8.1 / v8.2)
Notas:
  • speed=relax ou omitido não adiciona sufixo de speed; fast / turbo adicionam o sufixo correspondente.
  • Versões principais normalizam para v8.2, v8.1, v7, v6.1, v5.2, v5.1.
  • niji=true + version=7/6 normaliza para niji7 / niji6.
Veja o preço no console. Tarefas falhadas são totalmente reembolsadas.