ACR referenceProduct actions

preparePostGeneration

ACR Dashboard
POST
/v1/posts/generation-pricing

Runs the canonical account product command. Requires generations.image.create or generations.video.create according to controls.modality; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.

Authorization

bearerAuth
AuthorizationBearer <token>

Organization-scoped bearer credential. Credentials are scoped, revocable, and never represented by a Soul or operation ID.

In: header

Header Parameters

Idempotency-Key*string

Canonical product action UUID. Reuse for retries of the same action. Pricing and generation launch use distinct action UUIDs.

Formatuuid
X-Kallfi-Workspace-ID?string

Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Canonical Generate pricing preparation body. The dispatcher supplies pricingActionId from Idempotency-Key; the normal pricing owner binds quote/reference/commercial receipts to this Account and surface. Launch generation separately using the returned authorization and a new UUID action key.

Response Body

application/json

curl -X POST "https://acr.kallfi.red/v1/posts/generation-pricing" \  -H "Idempotency-Key: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "version": 2,    "outputOwner": {      "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5"    },    "prompt": "string",    "controls": {      "modality": "image",      "quality": "low",      "durationSeconds": null    },    "references": [      {        "id": "string",        "source": {          "type": "post_image",          "postId": "1d33c5d7-f0cb-41cc-a647-907f16832fc3",          "position": 0        }      }    ]  }'
{}