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

header

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

array

required

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

Show contents[]

string

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

array

required

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

Show parts[]

string

The text prompt or response content.

object

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

Show systemInstruction

array

required

An ordered list of parts that constitute the system instruction.

Show parts[]

string

The text content of the system instruction.

object

Configuration options for model generation and outputs.

Show generationConfig

number

Controls the randomness of the output.

number

The maximum cumulative probability of tokens to consider when sampling.

integer

The maximum number of tokens to consider when sampling.

integer

Number of generated responses to return.

integer

The maximum number of tokens to include in a candidate.

array

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

array

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

Show tools[]

array

A list of function declarations the model can call.

Show function_declarations[]

string

required

The name of the function to call.

string

A description of what the function does.

object

Describes the parameters for the function in JSON Schema format.

Show parameters

string

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

object

A map of parameter names to their schema definitions.

array

List of required parameter names.

object

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

object

Tool configuration for any Tool specified in the request.

Show toolConfig

object

Configuration for function calling behavior.

Show function_calling_config

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

array

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

array

A list of unique safety settings for blocking unsafe content.

Show safetySettings[]

string

The category for this setting (e.g. HARM_CATEGORY_HATE_SPEECH).

string

Block threshold for this category (e.g. BLOCK_MEDIUM_AND_ABOVE).

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