Compare AI prompts
compare_ai_promptsCompare answers from multiple AI models to the same synthetic prompt, including brand mentions and citations, for side-by-side analysis.
Instructions
Run the same synthetic prompt against supported models and compare answers, brand mentions and returned citations. These tests are not observed ChatGPT/AIO visibility. Requires a guaranteed hard cap or explicit actual-cost consent with an advisory estimate limit, and project write scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | Yes | Brand name to inspect. | |
| fresh | No | Hard-cap mode bypasses stored results. Actual-cost retries always reuse their durable request identity; fresh never re-dispatches a pending, unknown or completed attempt. | |
| domain | Yes | Local citation-matching hostname, without a scheme or path. Domain searches remove a leading www. only from the provider filter and require at most 63 characters after removal; local matching keeps the full hostname. Brand searches and prompt comparisons allow up to 253. | |
| models | No | Distinct model IDs advertised by get_ai_research_catalog. | |
| prompt | Yes | Same synthetic prompt for each model; maximum 2000 UTF-8 bytes. | |
| project_id | Yes | The public project ID. Project membership and token scopes are enforced. | |
| web_search | No | Enable provider web search when supported. | |
| cost_policy | No | Hard cap or explicitly consented non-guaranteed actual provider cost. | hard_cap |
| estimate_only | No | Return the cost estimate without paid provider I/O. | |
| max_cost_cents | No | Maximum accepted provider cost in cents. Estimates and cache reads do not spend credits. | |
| idempotency_key | No | Stable retry key sent as a header; actual-cost mode requires a UUID also sent in the body. | |
| country_iso_code | No | Country hint; requires web search. | |
| max_output_tokens | No | Maximum output tokens; provider limits also apply. | |
| response_language | No | Requested response language. | en |
| estimate_credentials_ref | No | Credential identity from the estimate, required for actual-cost execution. | |
| estimated_cost_limit_cents | No | Advisory estimate limit in cents for actual-cost consent. | |
| actual_cost_acknowledgement | No | Explicit acknowledgement that actual provider cost has no guaranteed maximum. |