Google - Format

Base-Path:

https://api.hyprlab.io

Non-Stream Path:

https://api.hyprlab.io/v1beta/models/[MODEL]:generateContent?key=[API-KEY]

Stream Path:

https://api.hyprlab.io/v1beta/models/[MODEL]:streamGenerateContent?alt=sse&key=[API-KEY]

Sample API Request

Basic Request:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": [
    {
      "role": "user",
      "parts": [{
        "text": "Hello"
      }]
    },
    {
      "role": "model",
      "parts": [{
        "text": "Great to meet you. What would you like to know?"
      }]
    },
    {
      "role": "user",
      "parts": [{
        "text": "I have two dogs in my house. How many paws are in my house?"
      }]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 8192,
    "response_mime_type": "text/plain"
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Image Input:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": {
    "parts": [
      {
        "inline_data": {
          "mime_type": "image/jpeg",
          "data": "'$(base64 /path/to/image.jpg)'"
        }
      },
      {
        "text": "What do you see in this image?"
      }
    ]
  },
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.9,
    "topK": 40,
    "max_output_tokens": 8192,
    "response_mime_type": "text/plain"
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Audio Input:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": {
    "parts": [
      {
        "inline_data": {
          "mime_type": "audio/mpeg",
          "data": "'$(base64 /path/to/audio.mp3)'"
        }
      },
      {
        "text": "What is being said in this audio?"
      }
    ]
  },
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 8192,
    "response_mime_type": "text/plain"
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Video Input:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": {
    "parts": [
      {
        "inline_data": {
          "mime_type": "video/mp4",
          "data": "'$(base64 /path/to/video.mp4)'"
        }
      },
      {
        "text": "What is happening in this video?"
      }
    ]
  },
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 8192,
    "response_mime_type": "text/plain"
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

File input:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": {
    "parts": [
      {
        "inline_data": {
          "mime_type": "application/pdf",
          "data": "'$(base64 /path/to/document.pdf)'"
        }
      },
      {
        "text": "What is this document about?"
      }
    ]
  },
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 8192,
    "response_mime_type": "text/plain"
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Structured Output:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": [{
    "parts": [{
      "text": "List 5 popular cookie recipes"
    }]
  }],
  "generationConfig": {
    "response_mime_type": "application/json",
    "response_schema": {
      "type": "ARRAY",
      "items": {
        "type": "OBJECT",
        "properties": {
          "recipe_name": {"type": "STRING"}
        }
      }
    }
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Function Calling:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful lighting system bot. You can turn lights on and off, and you can set the color. Do not perform any other tasks."
    }
  },
  "tools": [
    {
      "function_declarations": [
        {
          "name": "enable_lights",
          "description": "Turn on the lighting system.",
          "parameters": { "type": "object" }
        },
        {
          "name": "set_light_color",
          "description": "Set the light color. Lights must be enabled for this to work.",
          "parameters": {
            "type": "object",
            "properties": {
              "rgb_hex": {
                "type": "string",
                "description": "The light color as a 6-digit hex string, e.g. ff0000 for red."
              }
            },
            "required": ["rgb_hex"]
          }
        },
        {
          "name": "stop_lights",
          "description": "Turn off the lighting system.",
          "parameters": { "type": "object" }
        }
      ]
    }
  ],
  "tool_config": {
    "function_calling_config": {"mode": "none"}
  },
  "contents": {
    "role": "user",
    "parts": {
      "text": "What can you do?"
    }
  }
}'

Code Execution:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "tools": [{"code_execution": {}}],
  "contents": [
    {
      "role": "user",
      "parts": [{
        "text": "Can you print \"Hello world!\"?"
      }]
    },
    {
      "role": "model",
      "parts": [
        {
          "text": ""
        },
        {
          "executable_code": {
            "language": "PYTHON",
            "code": "\nprint(\"hello world!\")\n"
          }
        },
        {
          "code_execution_result": {
            "outcome": "OUTCOME_OK",
            "output": "hello world!\n"
          }
        },
        {
          "text": "I have printed \"hello world!\" using the provided python code block. \n"
        }
      ]
    },
    {
      "role": "user",
      "parts": [{
        "text": "What is the sum of the first 50 prime numbers? Generate and run code for the calculation, and make sure you get all 50."
      }]
    }
  ]
}'

Grounding: (Google Search Retrieval)

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": [
    {
      "role": "user",
      "parts": [{
        "text": "Hello"
      }]
    },
    {
      "role": "model",
      "parts": [{
        "text": "Great to meet you. What would you like to know?"
      }]
    },
    {
      "role": "user",
      "parts": [{
        "text": "What is the current Google stock price?"
      }]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 65536,
    "response_mime_type": "text/plain",
    "thinkingConfig": {
      "thinkingLevel": "HIGH",
      "includeThoughts": true
    }
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ],
  "tools": [
    {
      "google_search": {}
    }
  ]
}'

Thinking Mode:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": [
    {
      "role": "user",
      "parts": [{
        "text": "Hello"
      }]
    },
    {
      "role": "model",
      "parts": [{
        "text": "Great to meet you. What would you like to know?"
      }]
    },
    {
      "role": "user",
      "parts": [{
        "text": "9.11 and 9.8, which is greater?"
      }]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 65536,
    "response_mime_type": "text/plain",
    "thinkingConfig": {
      "thinkingLevel": "HIGH",
      "includeThoughts": true
    }
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Url Context: (Website Content Retrieval)

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3.1-pro:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "system_instruction": {
    "parts": {
      "text": "You are a helpful assistant."
    }
  },
  "contents": [
    {
      "role": "user",
      "parts": [{
        "text": "Hello"
      }]
    },
    {
      "role": "model",
      "parts": [{
        "text": "Great to meet you. What would you like to know?"
      }]
    },
    {
      "role": "user",
      "parts": [{
        "text": "Summarize the latest news of this Website: https://site.com/"
      }]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "topP": 0.95,
    "topK": 0,
    "max_output_tokens": 65536,
    "response_mime_type": "text/plain",
    "thinkingConfig": {
      "thinkingLevel": "HIGH",
      "includeThoughts": true
    }
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ],
  "tools": [
    {
      "url_context": {}
    }
  ]
}'

Image Generation:

curl -X POST "https://api.hyprlab.io/v1beta/models/gemini-3-pro-image:generateContent?key=API_HERE" \
-H "Content-Type: application/json" \
-d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Generate an image of a cute cat."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE",
      "TEXT"
    ]
  },
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}'

Learn More at: https://ai.google.dev/gemini-api/docs

✨ Gemini

Model Name:

gemini-3.1-pro

Discount:

60% off

Prompts upto 200K:

Input: $0.8 / 1M Tokens
Output: $4.8 / 1M Tokens

Prompts longer than 200K:

Input: $1.6 / 1M Tokens
Output: $7.2 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding
Thinking
URL Context

Model Name:

gemini-3.1-flash-lite

Discount:

60% off

Input:

$0.1 / 1M Tokens

Output:

$0.6 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding
Thinking
URL Context

Model Name:

gemini-3.1-flash-image

Discount:

50% off

Text Input:

$0.25 / 1M Tokens

Text Output:

$1.5 / 1M Tokens

Image Input:

$0.25 / 1M Tokens

Image Output:

$30 / 1M Tokens

Context Length:

65,536

Moderation:

Unfiltered

Capabilities:

Image Generation
Google Search
Image Search
Image Input
Structured Output

Model Name:

gemini-3-pro-image

Discount:

50% off

Text Input:

$1 / 1M Tokens

Text Output:

$6 / 1M Tokens

Image Input:

$1 / 1M Tokens

Image Output:

$60 / 1M Tokens

Context Length:

131,072

Moderation:

Unfiltered

Capabilities:

Image Generation
Grounding
Image Input
Structured Output

Model Name:

gemini-3-flash

Discount:

60% off

Input:

$0.2 / 1M Tokens

Output:

$1.2 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding
Thinking
URL Context

Model Name:

gemini-2.5-flash-image

Discount:

50% off

Text Input:

$0.15 / 1M Tokens

Text Output:

$1.25 / 1M Tokens

Image Input:

$0.15 / 1M Tokens

Image Output:

$15 / 1M Tokens

Context Length:

65,536

Moderation:

Unfiltered

Capabilities:

Image Generation
Image Input
Structured Output

Model Name:

gemini-2.5-pro

Discount:

60% off

Prompts upto 200K:

Input: $0.5 / 1M Tokens
Output: $4 / 1M Tokens

Prompts longer than 200K:

Input: $1 / 1M Tokens
Output: $6 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding
Thinking
URL Context

Model Name:

gemini-2.5-flash

Discount:

60% off

Input:

$0.12 / 1M Tokens

Output:

$1 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding
Thinking
URL Context

Model Name:

gemini-2.5-flash-lite

Discount:

60% off

Input:

$0.04 / 1M Tokens

Output:

$0.16 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding
Thinking
URL Context

Model Name:

gemini-2.0-flash

Discount:

60% off

Input:

$0.04 / 1M Tokens

Output:

$0.16 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling
Code Execution
Grounding

Model Name:

gemini-2.0-flash-lite

Discount:

60% off

Input:

$0.03 / 1M Tokens

Output:

$0.12 / 1M Tokens

Context Length:

1,048,576

Moderation:

Unfiltered

Capabilities:

Image Input
Audio Input
Video Input
File Input
Structured Output
Function Calling

PreviousOpenAI - Format NextIMAGE

Last updated 4 days ago

hashtagSample API Request

hashtag✨ Gemini

Sample API Request

✨ Gemini