Reroll

POST

https://api.piapi.ai/mj/v2/reroll

This endpoint from PiAPI's Midjourney API regenerates the images based on the new prompt and the parent task. This endpoint corresponds to the Re-run or Re-roll button from the offcial Midjourney.

Request

Header Params

X-API-Key

string

required

Insert your API Key here

Example:

Body Params application/json

origin_task_id

string

required

The task ID of the parent task.

prompt

string

optional

Use this parameter to modify the original prompt from the parent task.

skip_prompt_check

boolean

optional

Use this parameter to skip our internal prompt check. Default value: False.

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.

Example

{
    "origin_task_id": "6886fc4d************d912733806d5",
    "prompt": "a cute cat",
    "skip_prompt_check": false,
    "webhook_endpoint": "",
    "webhook_secret": ""
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piapi.ai/mj/v2/reroll' \
--header 'X-API-Key: {{x-api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "origin_task_id": "6886fc4d************d912733806d5",
    "prompt": "a cute cat",
    "skip_prompt_check": false,
    "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": "1a8149b1*************a644936daa21",
    "status": "success",
    "message": ""
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Modified at 2024-09-24 02:23:40

Imagine

Upscale