PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Midjourney
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
      • Create Task
      • Kling Virtual Try-On
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • LLM
      • How To Find GPTs Gizmo Name?
      • How To Avoid Timeouts in Completion API
      • Deepseek Models
      • GPT-4o Image Generation API
      • LLM API | Basic Completions
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Luma Dream Machine
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Create Task
      • Get Task
    • WanX
      • Available LoRA Types for Wanx
      • Generate WanX Task with LoRA Using PiAPI
      • Create Task
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Tools
      • File Upload API
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
  • Legacy Documentation
    • Midjourney
      • Midjourney Webhook
      • Imagine
        POST
      • Reroll
        POST
      • Upscale
        POST
      • Variation
        POST
      • Inpaint
        POST
      • Outpaint
        POST
      • Pan
        POST
      • Describe
        POST
      • Blend
        POST
      • Seed
        POST
      • Fetch
        POST
      • Multi Fetch
        POST
      • Cancel
        POST
    • Face Swap
      • Video Faceswap
      • Multi-face-swap
      • Fetch
    • Dream Machine
      • Video Generation
      • Video Extend
      • Get Video Generation
    • Kling
      • Video Generation
      • Video Extend
      • Get Video Generation
  1. Midjourney

Imagine

POST
https://api.piapi.ai/mj/v2/imagine
This endpoint from PiAPI's Midjourney API generates 4 unique images in a 2x2 grid from a text description also known as prompt. This endpoint corresponds with the /imagine command from the offical Midjourney.
Image2image - how can I avoid the latency incurred from uploading my images to a server, your team fetches that image, and upload the image onto the Discord server?
If you upload your images onto the servers with the following domains, we will not transfer them again to the Discord server
1.
imgur.space
2.
img.goodfon.ru
3.
goo.gl
4.
fb-cd.fanbook.cn
5.
i.ibb.co
6.
fanbook.cn
7.
cdn.midjourney.com

Request

Header Params
X-API-KEY
string 
required
Insert your API Key here
Example:
{{x-api-key}}
Body Params application/json
prompt
string 
required
A prompt is a description that enables Midjourney API to produce an image.
skip_prompt_check
boolean 
optional
Use this parameter to skip our internal prompt check. Default value: False.
process_mode
string 
optional
This parameter indicates the operation process mode: relax/fast/turbo.
aspect_ratio
string 
optional
This parameter dictates the ouput image's aspect ratio value. Default value: 1:1.
webhook_endpoint
string 
optional
Task notifications will be sent to the indicated address. The acceptable address can either be a domain or port 443.
webhook_secret
string 
optional
This value will be passed as the x-webhook-secret field in the headers as part of the response.
bot_id
integer 
optional
Only Host-Your-Account users on the Pro Plan can use this parameter. This parameter specifies which Midjourney account will process this task.
Example
{
  "prompt": "a cute puppy",
  "process_mode": "relax",
  "aspect_ratio": "4:3",
  "webhook_endpoint": "",
  "webhook_secret": ""
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.piapi.ai/mj/v2/imagine' \
--header 'X-API-KEY: {{x-api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "a cute puppy",
    "process_mode": "relax",
    "aspect_ratio": "4:3",
    "webhook_endpoint": "",
    "webhook_secret": ""
}'

Responses

🟢200OK
application/json
OK - Successful Response
Body
task_id
string 
optional
status
string 
optional
message
string 
optional
Example
{
  "task_id": "5b01d63a**************812323adf8e1",
  "status": "success",
  "message": ""
}
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2024-10-23 07:10:56
Previous
Midjourney Webhook
Next
Reroll