Get Task Details

GET https://modelfold.ai/api/v1/jobs/recordInfo?taskId=...

Use the creating Key in Authorization: Bearer mf-... and the task ID returned by ModelFold. Other API Keys cannot query the job. Upstream task IDs are not accepted.

curl "https://modelfold.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY"

data.state is queued, submitting, processing, uncertain, success or fail. On success, parse data.resultJson to read absolute resultUrls. On failure, read data.failMsg. At a terminal state, data.usage.credits is the actual ModelFold charge (0 after failure/refund); beforehand it is the reserved amount. data.callback describes customer notification delivery.

Poll every 5–10 seconds and stop at a terminal state. Queries only read saved results, without resubmission or additional charges. Polling can be combined with callbacks.

See complete creation, query, billing and callback examples. Existing synchronous endpoints still return results in the original request and do not require this query.