Retry a Factory run's failed clips

Make the run’s failed clips (all, or clipIds) again, as a new Factory run: clips no worker delivered (no GPU worker within the queue deadline, a worker error), each on the seed it was to have. A clip whose generation succeeded on the GPU but failed after it (its outputs judged or delivered wrong) takes that generation again instead of a new one, for no GPU time. Distinct from retry-flagged, which re-generates delivered but flagged clips on new seeds. Its accepted clips are charged; maxCostCents and Idempotency-Key as for a run.

POST /api/v1/factory/runs/{id}/retry-failed

Retry a Factory run's failed clips

cURL

curl --request POST \
  --url https://dev.simforge.ai/api/v1/factory/runs/{id}/retry-failed \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "maxCostCents": 1,
  "clipIds": [
    "<string>"
  ]
}
'

201

{
  "runId": "<string>",
  "clips": 1,
  "costEstimateCents": 1
}

Authorizations

Authorization · string · header · required

A sfc_at_… access token from simforge login, or an sfk_… API key. An operation's security lists the scopes the credential must hold.

Headers

Idempotency-Key · string · required

Required string length: 1 - 200

Path Parameters

id · string · required

Body

application/json

maxCostCents · integer · required

The most the retries may charge (every retried clip accepted).

Required range: x >= 0

clipIds · string[]

Flagged clips of the run to retry; absent: every flagged clip.

Required array length: 1 - 5000 elements

Minimum string length: 1

Response

201

application/json

The retry run.

runId · string · required

The run the retries go to (a new factory_batch run of the flagged clips).

clips · integer · required

Required range: x >= 0

costEstimateCents · integer · required

Required range: x >= 0