Unique identifier for this specific AI image transaction. Used for deduplication, correlation with request/response pairs, and transaction lookup in Revenium analytics. If not provided, a UUID will be auto-generated. For best practices, generate a UUID in your application before making the AI call and use the same ID when submitting to Revenium. You can use either 'spanId' (recommended) or 'transactionId'.

Optional trace identifier to group multiple related AI image calls that belong to the same overall user request or workflow. For example, if a single user query triggers multiple AI calls (e.g., generation + variation), use the same traceId for all calls to analyze them together in Revenium's analytics. Leave null for standalone operations.

The type of operation performed

Technical classification of the specific image operation. Valid values: 'generation', 'edit', 'variation', 'upscale', 'inpainting'. Invalid values will be rejected with HTTP 400. Recommended for billing routing - missing values are accepted with a warning.

The name of the subscriber's organization from your system to allow Revenium to track usage & costs by company. i.e. AcmeCorp. If several subscriberIds have the same organizationName, Revenium's reporting will show usage for the entire organization broken down by subscriberId. This field is used for lookup and auto-creation of organizations in Revenium.

Unique identifier of the subscription from your own system that you wish to use to correlate usage between Revenium & your application.

The name of the product from your system that you wish to use to correlate usage between Revenium & your application. This field is used for lookup and auto-creation of products in Revenium.

The AI agent that is making the request

Deployment environment where this AI image operation was executed. Used for filtering and analyzing usage patterns across different deployment stages. Common values: 'production', 'staging', 'development', 'test'. Leave null if not tracking by environment.

Cloud region or geographic location where this AI image operation was processed. Used for analyzing latency patterns, compliance requirements, and regional cost differences. Examples: 'us-east-1', 'eu-west-1', 'ap-southeast-2'. Leave null if not tracking by region.

Parent transaction ID for hierarchical tracing. When an AI image operation is part of a larger workflow or spawned by another AI call, this field references the parent's spanId/transactionId. Used to build transaction trees and understand call hierarchies in complex multi-step AI workflows. Leave null for root-level transactions. You can use either 'parentSpanId' (recommended) or 'parentTransactionId'.

Human-readable name for this transaction. Provides context about what this AI image operation is doing in business terms. Examples: 'Generate Product Image', 'Create Marketing Banner', 'Edit Background'. Used in trace visualization for better readability. Falls back to taskType if not provided.

Categorical identifier for grouping similar workflows (e.g., 'product_image_generation', 'marketing_assets'). Enables trace-level analytics and anomaly detection within workflow cohorts. Must contain only alphanumeric characters, hyphens, and underscores. Max 128 characters. Defaults to 'uncategorized' if not provided or invalid. All transactions in the same trace must have the same traceType.

Human-readable label for individual trace instances (e.g., 'Marketing Campaign Q4'). Enables finding specific workflow executions. Can contain any UTF-8 string. Max 256 characters. All transactions in the same trace must have the same traceName.

Identifier for multi-agent framework team or squad (e.g., ARK, CrewAI). Used to group AI operations by agent team for analytics and cost tracking. Free-form string, max 256 characters.

Human-readable name for the squad type (e.g., 'Loan Processing', 'Document Analysis'). Used for display in the UI and analytics grouping. If squadId is provided without squadName, squadId will be used as the display name.

The agent's role within this squad execution (e.g., 'Document Extractor', 'Credit Checker'). Used to identify the purpose of each agent's contribution to the squad workflow.

Unique identifier for the agentic job instance. Used to correlate all AI operations within a single job execution. Should be unique per job run (e.g., UUID or meaningful ID like 'loan-123-processing').

Human-readable name for the agentic job. Used for display in the UI and analytics grouping. If agenticJobId is provided without agenticJobName, the ID will be used as the display name.

Category or type of the agentic job. Normalized to lowercase on ingest to prevent data fragmentation. Used for grouping jobs by type in analytics and ROI calculations.

Version identifier for the job definition. Used to track job evolution and compare performance across versions.

Error message or reason if the AI image operation failed. Include this field when the AI provider returns an error (e.g., content policy violation, rate limit exceeded, invalid parameters). Used for error rate analytics and debugging. Leave null for successful operations.

Identifier of the Revenium middleware package or SDK that captured and submitted this AI image metadata. This field is AUTOMATICALLY SET by Revenium's middleware packages (e.g., 'revenium-openai-python', 'revenium-stability-node'). You typically should NOT manually set this field. It is used for analytics to track which integration methods are being used and for debugging middleware-specific issues.

The routing or aggregation layer used to access the AI model. This identifies whether you're calling the AI provider directly or through an intermediary service.

Common values: 'DIRECT', 'LITELLM', 'OPENROUTER', 'PORTKEY', or provider names when calling directly.

Custom values are accepted for specialized routing layers or gateways. This field is used for integration tracking and analytics.

Optional category to group related AI tasks for cost and performance analysis. Use consistent values to compare metrics across different models or vendors performing the same type of work. Examples: 'image-generation', 'product-photos', 'marketing-assets', 'avatar-creation'. This is freeform text - choose values that match your use cases.

Image resolution (e.g., '1024x1024', '1792x1024', '512x512').

Image quality setting (e.g., 'standard', 'hd'). HD typically costs 2x standard.

Image style for DALL-E 3 (e.g., 'vivid', 'natural'). Does not affect pricing.

Output format for the generated image (e.g., 'url', 'b64_json'). Does not affect pricing. Used for analytics only.

Links this operation to a source transaction (e.g., variation links to original generation). Used for lineage tracking in analytics.

Input prompts/messages for this image generation. JSON-serialized array of messages in the same format as the LLM endpoint. Used for prompt analytics and cost attribution.

Output response content or metadata (e.g., generated image URLs, dimensions). Used for analytics and audit trail.

Reason why billing was skipped.

Pricing tier for batch discounts. BATCH = 50% discount, STANDARD = normal pricing.

Service tier requested by user (e.g., 'priority', 'default', 'flex').

Actual service tier used for billing. May differ from requested if downgraded. Backend uses this for cost calculation.

Google priority tier for Vertex AI pricing. 'best_effort' = -30%, 'on_demand' = base rate, 'committed' = -20%. Only applies to Google providers.