Authorize a prompt
Submit a prompt for authorization, and get a price estimate if approved.
Authorizations
API key issued for Interchange; reach out to Loti to obtain an API key.
Headers
UUIDv7 idempotency key. Required for media prompts and unsupported for text-only prompts.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Body
- Option 1
- Option 2
Required for media prompts; receives the completed authorization response. HTTPS is required in every environment.
4096If true, the request may be processed asynchronously and acknowledged before the full result is available.
Response
Prompt was successfully evaluated. Check authorizationResult field: 'authorized' means the prompt can proceed; 'not_authorized' means it was denied (see authorizationDeniedCode and authorizationDeniedReason for details).
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ISO 8601 timestamp in UTC.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ISO 8601 timestamp in UTC.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Original prompt text provided by the requester.
1Experimental: Prompt text after enhancement, if applied. This field may be removed in a future API version.
Experimental: Strictness level applied by the enhancer. This field may be removed in a future API version.
1 <= x <= 5^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Type of content being generated.
image, video, audio_voice Type of license for content usage: personal (non-commercial), limited_commercial (small business/limited reach), or major_commercial (large campaigns, requires approval).
personal, limited_commercial, major_commercial Unit of generated content, for billing purposes.
word_count, asset_count, length_seconds Provider-supplied estimate of how many pricing units will be generated.
0 < x <= 86400Estimated total price in micros (millionths of a USD); null when authorization is denied.
0 <= x <= 9007199254740991Outcome of prompt authorization: 'authorized' (prompt approved, proceed to generate), 'not_authorized' (prompt denied, see authorizationDeniedCode and authorizationDeniedReason), 'failed' (authorization could not be completed), or 'pending' (still processing).
pending, authorized, not_authorized, failed If prompt authorization was denied, contains a machine-readable code describing the denial reason.
RULES_VIOLATION, RULES_NOT_CONFIGURED, RATE_CARD_NOT_CONFIGURED, INCOMPLETE_PRICING, NO_IDENTITIES, NO_TEXT, IDENTITIES_NOT_FOUND, MAJOR_COMMERCIAL_NOT_SUPPORTED, NO_AGREEMENT_FOR_LICENSE_TYPE If prompt authorization was denied, contains a human-readable explanation of the reason for denial.
DEPRECATED - use identityReferenceAssets. If prompt was authorized, maps each Loti identity ID to a single biometric asset URL for the requested content type (legacy identity_asset source).
If prompt was authorized, maps each Loti identity ID to its active generation-ready reference assets, grouped by asset type (image, audio_voice) and ordered oldest-first (the first image is the canonical/frontal reference).