# Gemini API model responses

Live Gemini LLM Responses endpoint allows you to retrieve structured responses from a specific Gemini AI model, based on the input parameters. Needs user prompt and model name. Served by DataForSEO.

Live Gemini LLM Responses endpoint allows you to retrieve structured responses from a specific Gemini AI model, based on the input parameters.

- Tool ID: `dataforseo/ai-optimization-gemini-llm-responses`
- Name in the catalog: Ai Visibility Gemini Llm Responses
- Provider: [DataForSEO](/providers/dataforseo.md)
- Capability: [ChatGPT, Claude, Gemini & Perplexity answers](/tools/ai-visibility/llm-responses.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "cost",
  "maxUsdDefault": 0.00085,
  "maxUsdCap": 100,
  "multipliers": [
    {
      "addUsdPer": {
        "field": "max_output_tokens",
        "usd": 4e-7,
        "default": 256,
        "max": 1024
      }
    }
  ],
  "requireCost": true
}
```

Pricing source: [https://docs.dataforseo.com/v3/appendix/user_data/](https://docs.dataforseo.com/v3/appendix/user_data/). Account tariff ai_optimization/llm_responses/live; bounds applied to inputs; actual cost from provider response..

Price verification date: 2026-10-10.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "user_prompt": {
      "type": "string",
      "description": "prompt for the AI model required field the question or task you want to send to the AI model; you can specify up to 500 characters in the user_prompt field",
      "maxLength": 500,
      "minLength": 1
    },
    "model_name": {
      "type": "string",
      "description": "name of the AI model required field model_nameconsists of the actual model name and version name; if the basic model name is specified, its latest version will be set by default; for example, if gemini-1.5-pro is specified, the gemini-1.5-p",
      "maxLength": 2000,
      "minLength": 1,
      "enum": [
        "gemini-2.5-flash-lite"
      ],
      "default": "gemini-2.5-flash-lite"
    },
    "max_output_tokens": {
      "type": "integer",
      "description": "maximum number of tokens in the AI response optional field minimum value: 1 maximum value: 4096; default value: 2048; Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed t",
      "minimum": 16,
      "maximum": 1024,
      "default": 256
    },
    "temperature": {
      "type": "number",
      "description": "randomness of the AI response optional field higher values make output more diverse lower values make output more focused minimum value: 0 maximum value: 2 default value: 1.3",
      "minimum": 0,
      "maximum": 2
    },
    "top_p": {
      "type": "number",
      "description": "diversity of the AI response optional field controls diversity of the response by limiting token selection minimum value: 0 maximum value: 1 default value: 0.9",
      "minimum": 0,
      "maximum": 1
    },
    "use_reasoning": {
      "type": "boolean",
      "description": "enable reasoning for the AI model optional field when enabled, the model will perform reasoning before generating a response refer to the Models endpoint for a list of models that support reasoning default value: false Note: if set to true,",
      "const": false,
      "default": false
    },
    "tag": {
      "type": "string",
      "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
      "maxLength": 255
    }
  },
  "required": [
    "user_prompt",
    "model_name"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "dataforseo/ai-optimization-gemini-llm-responses",
  "input": {
    "max_output_tokens": 256,
    "temperature": 0.3,
    "model_name": "gemini-2.5-flash-lite",
    "user_prompt": "provide information on how relevant the amusement park business is in France now",
    "use_reasoning": false
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://docs.dataforseo.com/v3/ai_optimization/gemini/llm_responses/live/)

[REST inspection](https://api.agentik.cc/v1/tools/dataforseo/ai-optimization-gemini-llm-responses) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/dataforseo/ai-optimization-gemini-llm-responses) · [Agent index](/llms.txt)