Skip to main content
POST
mj-v8.2-retexture Interface
Midjourney has a built-in content moderation system. Each image is moderated individually: filtered images are left out of the results and the remaining images are delivered normally, so you may receive fewer images than usual. If at least one image passes, the task is completed and billed normally; if all images are filtered, the task ends as failed and the reserved credits are refunded in full. Please make sure your prompts and reference images comply with the content guidelines.

Authorizations

Authorization
string
header
required

All endpoints require Bearer Token authentication

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Body

application/json
model
enum<string>
default:mj-v8.2-retexture
required

Model name

Available options:
mj-v8.2-retexture
Example:

"mj-v8.2-retexture"

prompt
string
required

Describe target texture/style

Maximum string length: 8100
Example:

"Cyberpunk neon style"

image_urls
string<uri>[]
required

Input image URL (uses the first one). Public HTTP(S) URL of at most 1024 characters; formats .png, .gif, .webp, .jpg, .jpeg

Maximum array length: 1
Example:
model_params
object

Model parameters

callback_url
string<uri>

HTTPS callback URL for task completion

Callback timing:

  • Triggered when the task is completed or failed
  • Sent after billing confirmation

Security restrictions:

  • HTTPS protocol only
  • Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • URL length must not exceed 2048 characters

Callback mechanism:

  • Timeout: 10 seconds
  • Up to 3 retries after failure (retries at 1s/2s/4s after failure)
  • Callback response body format matches the task query endpoint
  • A 2xx status code is considered successful; other status codes trigger retries
Example:

"https://your-domain.com/webhooks/image-task-completed"

Response

Image generation task created successfully

created
integer

Task creation timestamp

Example:

1757165031

id
string

Task ID

Example:

"task-unified-1757165031-mjv82"

model
string

Actual model name used

object
enum<string>

Task object type

Available options:
image.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object
type
enum<string>
Available options:
text,
image,
audio,
video
Example:

"image"

usage
object