Gemini Text generation - ZnapAI Documentation

Request

curl --location 'https://api.znapai.com/gemini/v1beta/models/gemini-3.1-flash-lite-preview:generateContent' \
--header 'x-goog-api-key: $ZnapAI_API_KEY' \
--header 'Content-Type: application/json' \
--header 'spend-logs-metadata: {"user_id": "user-123", "project_id": "proj_abc", "env": "production"}' \
--data '{
    "contents": [{
      "parts": [{"text": "Say hello"}]
    }]
  }'

Response

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Hello! How can I help you today?",
                        "thoughtSignature": "EjQKMgG+Pvb77bf2HCbvhPqtGFBZnNbcz3s5bMch0bEGM796BQfxY+30wIBcyFIObyExxedG"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 2,
        "candidatesTokenCount": 9,
        "totalTokenCount": 11,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 2
            }
        ]
    },
    "modelVersion": "gemini-3.1-flash-lite-preview",
    "responseId": "73HeadnqD7_Zg8UP5tae2Q0"
}

Parameters

spend-logs-metadata

header

An optional header used for spend logging metadata, containing JSON properties like user_id, project_id, and env.

contents

array

required

The conversation history or input prompts as an array of content objects.

Hide contents[]

role

string

The role of the creator of the content (e.g. "user" or "model").

parts

array

required

An ordered list of parts that constitute a single message turn.

Hide parts[]

text

string

The text prompt or response content.

systemInstruction

object

System instructions that provide context, rules, or guidelines to the model.

Hide systemInstruction

parts

array

required

An ordered list of parts that constitute the system instruction.

Show parts[]

text

string

The text content of the system instruction.

generationConfig

object

Configuration options for model generation and outputs.

Hide generationConfig

temperature

number

Controls the randomness of the output.

topP

number

The maximum cumulative probability of tokens to consider when sampling.

topK

integer

The maximum number of tokens to consider when sampling.

candidateCount

integer

Number of generated responses to return.

maxOutputTokens

integer

The maximum number of tokens to include in a candidate.

stopSequences

array

A list of strings that tell the model to stop generating text.

tools

array

A list of Tools the model may use to generate the next response. Supported tools are function declarations and code execution.

Hide tools[]

function_declarations

array

A list of function declarations the model can call.

Show function_declarations[]

name

string

required

The name of the function to call.

description

string

A description of what the function does.

parameters

object

Describes the parameters for the function in JSON Schema format.

Show parameters

type

string

The type of the parameters object. Usually "object".

properties

object

A map of parameter names to their schema definitions.

required

array

List of required parameter names.

code_execution

object

Enables the model to execute code as part of generation. Pass an empty object {} to enable.

toolConfig

object

Tool configuration for any Tool specified in the request.

Hide toolConfig

function_calling_config

object

Configuration for function calling behavior.

Show function_calling_config

mode

string

Controls how the model uses the provided functions. One of:

"AUTO" — model decides whether to call a function or respond in text
"ANY" — model must call one of the provided functions
"NONE" — model must not call any functions

allowed_function_names

array

Optional. When mode is "ANY", limits the model to only call functions from this list.

safetySettings

array

A list of unique safety settings for blocking unsafe content.

Hide safetySettings[]

Params to Avoid

Param	Reason
`model`	Model is specified in the URL path, not in the request body
`messages`	Native Gemini API uses `contents`, not `messages`
`max_tokens`	Use `generationConfig.maxOutputTokens` instead
`temperature`	Use `generationConfig.temperature` instead
`top_p`	Use `generationConfig.topP` instead
`top_k`	Use `generationConfig.topK` instead
`stop`	Use `generationConfig.stopSequences` instead
`presence_penalty`	Not natively supported by Gemini
`frequency_penalty`	Not natively supported by Gemini
`spend-logs-metadata`	This metadata must be passed as an HTTP header, not in the JSON request body

​Request

​Response

​Parameters

​Params to Avoid

Request

Response

Parameters

Params to Avoid