v18

latestOpenAPI 3.1.1raw.githubusercontent.com2026-05-2522769.4 KB
Predictions

Get prediction status

Poll for the status of a specific prediction using its ID. Use this endpoint to track prediction progress and retrieve results.

Status States:

  • starting - Prediction is being initialized
  • in_queue - Prediction is waiting to be processed
  • processing - Model is actively generating your result
  • completed - Generation finished successfully, output available
  • failed - Generation failed, check error details

Output Availability:

  • CDN URLs (default): Available for 72 hours after completion
  • Base64 outputs (when return_base64: true): Available for 60 minutes after completion
get/v1/status/{id}

Path parameters

idstring required
Example:123a87r9-4129-4bb3-be18-9c9fb5bd7fc1-u1

The unique prediction ID returned from the /v1/run endpoint

Response

Prediction status retrieved successfully

idstring required

The unique prediction ID

status'starting' | 'in_queue' | 'processing' | 'completed' | 'failed' | 'canceled' | 'time_out' required

Current status of the prediction

Example response

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1-u1",
  "status": "completed",
  "output": [
    "https://cdn.fashn.ai/output/image1.jpg",
    "https://cdn.fashn.ai/output/image2.jpg"
  ],
  "error": {
    "name": "ImageLoadError",
    "message": "Error loading model image: Invalid URL format"
  }
}