Skip to main content

Midjourney API Async Workflow

The Midjourney API on TTAPI is centered around asynchronous task handling. This guide helps you decide when to submit, when to poll, and when to continue a finished job.

Core Async Pattern

The most common pattern is:
  1. Submit a job through Imagine, Blend, or Inpaint
  2. Receive a jobId
  3. Poll the Midjourney Fetch API
  4. Trigger a follow-up operation through the Midjourney Action API if needed

Which Endpoint Starts The Job

Use caseStarting endpoint
Prompt-based image generationImagine
Multi-image compositionBlend
Region editingInpaint
Prompt extractionDescribe

When To Poll Fetch

Use Midjourney Fetch when:
  • You need final image URLs
  • You want to know whether the task succeeded or failed
  • Your app needs the finished components before calling an action

When To Use Action

Use Midjourney Action after a successful generation when you want:
  • Upscale
  • Variation
  • Reroll
  • Zoom
  • Pan

Common Midjourney Async Paths

WorkflowPath
Text prompt to final imageImagine -> Fetch
Grid to upscale or variationImagine -> Fetch -> Action
Image blend workflowBlend -> Fetch
Localized image editingInpaint -> Fetch
Last modified on April 14, 2026