Get Generation Costs

{
  "generationId": "generationId",
  "generationStatus": "generationStatus",
  "currency": "currency",
  "availability": "complete",
  "totalCostUsd": "totalCostUsd",
  "knownSubtotalUsd": "knownSubtotalUsd",
  "retryAfterSeconds": 1,
  "components": [
    {
      "type": "lipsync",
      "operationId": "operationId",
      "status": "recorded",
      "amountUsd": "amountUsd",
      "credits": "credits",
      "valueBasis": "credit_face_value",
      "quantity": 1.1,
      "unit": "frames",
      "unitRateUsd": "unitRateUsd",
      "source": "credit_ledger",
      "reason": "reason"
    },
    {
      "type": "lipsync",
      "operationId": "operationId",
      "status": "recorded",
      "amountUsd": "amountUsd",
      "credits": "credits",
      "valueBasis": "credit_face_value",
      "quantity": 1.1,
      "unit": "frames",
      "unitRateUsd": "unitRateUsd",
      "source": "credit_ledger",
      "reason": "reason"
    }
  ],
  "excludedCosts": [
    "excludedCosts",
    "excludedCosts"
  ]
}

Read the recorded costs for a generation. Credit amounts are USD face value, not cash paid. Metered amounts exclude invoice adjustments and tax. A null total means one or more components are pending or unavailable. This endpoint does not estimate prices or change billing.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

idstringRequired

A unique identifier for the generation.

Response

This endpoint returns an object.

generationIdstring

generationStatusstring

currencystring

Always USD.

availabilityenum

Allowed values:

totalCostUsdstring or null

Total as a decimal USD string. Null if any component is pending or unavailable.

knownSubtotalUsdstring

Sum of available amounts. This may be less than the final total.

retryAfterSecondsinteger or null

Suggested wait before checking again, when provided.

componentslist of objects

excludedCostslist of strings

Costs excluded from this response.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error