Status Check
Monitor the processing status of your requests. Use this endpoint to check the progress and retrieve results from asynchronous AI generation operations.
Endpoint
GET https://api.mnmlai.dev/v1/status/{id}Request
Send a GET request to check the status of a previously submitted AI generation task.
Required Parameters
| Parameter | Type | Description |
|---|---|---|
id | String | The request ID returned from any AI generation endpoint |
Response
The status check response provides information about the processing status of your request. When processing is complete, it will include URLs to the generated images.
Response Status Values
| Status | Description |
|---|---|
starting | Request has been received and is being prepared for processing. |
processing | Request is currently being processed by the AI system. |
success | Processing completed successfully. Includes message array with result URLs and seed. |
failed | Processing failed due to an error. Error details may be included in the response. |
canceled | Request was canceled before processing completed. |
Examples
Example Request
curl --location 'https://api.mnmlai.dev/v1/status/YOUR_REQUEST_ID' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'Success Response
{
"status": "success",
"message": [
"https://api.mnmlai.dev/v1/images/yhqm/3LbCGIZZuEIFKxWKqHlsLYXxuJfuFhTWS2ydpCIH3fT9T2OUA/453463-f663c9fa-e9e7-11ef-8909-1a12c9b2cbd2.png"
],
"seed": 453463
}Best Practices
Implement exponential backoff when polling for status updates to avoid rate limiting.
Store the request ID securely as it is required to retrieve your generated content.
Download and store generated images as soon as they're available - image URLs may expire after a certain period.
Error Handling
For detailed information on error responses, status codes, and best practices for handling errors, see our comprehensive API Errors documentation.
Status Check Specific Errors
// 400 Bad Request - Invalid request ID format
{
"error": "Invalid request ID format"
}
// 404 Not Found - Request ID not found
{
"error": "Request ID not found"
}Related Endpoints
Explore other AI-powered design tools that use asynchronous processing: