API center

The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.

Parameters

No path or query parameters.

Request body

actual_quantity string

capability_id string

Optional published capability identity from its execution profile. Nexus validates it against offer_id and freezes the revision on the Operation.

customer_account_id string

dimensions_json string

estimated_quantity string

execution_status string

SUCCEEDED or FAILED. A FAILED operation is handled by the failure-charge policy.

failure_code string

meter_code string

The single meter that determines the credit reservation and settlement.

model string

offer_id string

operation_key string

operation_type string

AUDIO_TRANSCRIBE, AUDIO_SPEECH, AUDIO_GENERATE or AUDIO_PROCESS.

provider string

provider_request_id string

source_event_id string

Stable upstream event ID. Reusing it makes a callback retry idempotent.

curl --request POST 'https://nexus-api.rainlib.com/v1/audio/usage:complete' \
  --header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "actual_quantity": "<value>",
  "capability_id": "<value>",
  "customer_account_id": "<value>",
  "dimensions_json": "<value>",
  "estimated_quantity": "<value>",
  "execution_status": "<value>",
  "failure_code": "<value>",
  "meter_code": "<value>",
  "model": "<value>",
  "offer_id": "<value>",
  "operation_key": "<value>",
  "operation_type": "<value>",
  "provider": "<value>",
  "provider_request_id": "<value>",
  "source_event_id": "<value>"
}'

Response contract

Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.