Skip to main content

Endpoint

GET https://api.eachlabs.ai/v1/prediction/{id}

Path Parameters

ParameterTypeRequiredDescription
idstringYesPrediction ID returned from Create Prediction

Code Examples

curl https://api.eachlabs.ai/v1/prediction/abc123-def456-ghi789 \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "id": "abc123-def456-ghi789",
  "input": {
    "prompt": "A beautiful sunset over the ocean with vibrant colors",
    "aspect_ratio": "16:9"
  },
  "status": "success",
  "output": "https://storage.example.com/predictions/abc123/image.jpg",
  "logs": null,
  "metrics": {
    "predict_time": 12.5,
    "cost": 0.05
  },
  "urls": {
    "cancel": "https://api.eachlabs.ai/v1/prediction/abc123-def456-ghi789/cancel",
    "get": "https://api.eachlabs.ai/v1/prediction/abc123-def456-ghi789"
  }
}

Response Fields

FieldTypeDescription
idstringPrediction ID
inputobjectInput parameters used
statusstringstarting, processing, success, failed, or cancelled
outputstring | array | objectPrediction output (type depends on model)
logsstring | nullExecution logs
metrics.predict_timenumberProcessing time in seconds
metrics.costnumberCost in USD
urls.cancelstringURL to cancel the prediction
urls.getstringURL to re-fetch this prediction

Prediction Status Values

StatusDescription
startingPrediction is initializing
processingModel is processing the input
successPrediction completed successfully
failedPrediction failed
cancelledPrediction was cancelled

Error Responses

StatusBodyDescription
404{"error": "Prediction not found"}Invalid prediction ID
500{"error": "Internal server error"}Server error
Last modified on March 3, 2026