credits

Check Media Credits

Changed on

Read media entitlement and net credit balance without admitting, holding or submitting a job.

Uses the provider proxy's model policy, including what Free includes (catalog.voyager_free_media_refusal); Free's monthly media counts are in balance.limits.media. Null availability means the plan or model eligibility could not be verified. hold_credits is what the provider proxy's admission would hold for one job of this exact request (its duration, resolution and route), so a batch of N needs N times it free. Balance, limits and the hold remain advisory: admission rechecks them, and no credits are reserved by this request.

A meshy check (endpoint the 3D operation, input Meshy's request body) uses POST /v1/media/generate-3d's plan gate and hold instead: one task's hold, at the payer's rate.

post/credits/check

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/credits/check
  • Auth
    HTTP bearer

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Request body

provider'fal' | 'google' | 'audio' | 'voice' | 'meshy' required
endpointstring required

The model or endpoint the generation would call. For meshy, the 3D operation (POST /v1/media/generate-3d's operation: image-to-3d, multi-image-to-3d, ...).

inputobject

The generation's input. For meshy, Meshy's request body as generate-3d takes it; its URLs and task_ refs are not read.

Example request

{
  "provider": "fal"
}

Response

Successful Response

availableboolean nullable required
required_planstring nullable
model_namestring nullable
hold_creditsinteger nullable

Credits an admission of this exact request would hold per job now, in the payer's credits: the figure each job of a batch must find free; for meshy, what generate-3d would hold for one task. Null when it was not sized (a model the plan refuses, an audio or voice request, or a read that failed).

Changes