Gemini StructuredOutputCompletion

Gemini StructuredOutputCompletion

Certified

Generate JSON with a Gemini schema

Calls Gemini with a prompt and enforces a JSON response shaped by the provided JSON Schema. Response MIME type is fixed to application/json and token metrics are emitted. See Gemini API about structured output completion for more information.

yaml
type: io.kestra.plugin.gemini.StructuredOutputCompletion

Structured JSON Output Completion using the Gemini Client.

yaml
id: gemini_structured_json_completion
namespace: company.team

tasks:
  - id: gemini_structured_json_completion
    type: io.kestra.plugin.gemini.StructuredOutputCompletion
    apiKey: "{{ secret('GEMINI_API_KEY') }}"
    model: "gemini-2.5-flash-lite"
    prompt: What are the weather predictions for tomorrow in London?
    jsonResponseSchema: |
        {
            "type": "object",
            "properties": {
                "predictions": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "content": {
                                "type": "string"
                            }
                        }
                    }
                }
            }
        }
Properties

Gemini API key

Secret used for direct Gemini API calls; render from a secure variable.

Response JSON Schema

Draft-style JSON Schema string that constrains the model output.

Generative model

Gemini model identifier to call (e.g., gemini-2.5-flash, gemini-1.5-pro). Must support the requested input type.

Text prompt

Prompt sent to the model before JSON shaping.

Reference (ref) of the pluginDefaults to apply to this task.

SubTypestring

List of text predictions made by the model

The number of candidate tokens generated by the Gemini model.

The number of tokens used in the input prompt.

The total number of tokens processed by the Gemini model (prompt + generated).