Docs
  1. Gemini
Docs
  • Introduction
  • Quick Start Guide
  • Make a request
  • YEScale System API Tutorial
  • Chat Models
    • ChatGpt
      • ChatGPT (Audio)
        • Create transcription by gpt-4o-mini-transcribe & gpt-4o-transcribe
        • Create a voice with gpt-4o-mini-tts
        • Create a voice
        • Create a transcript
        • Create translation
      • ChatGPT (Chat)
        • Chat completion object
        • Create chat completion (streaming)
        • Create chat completion (non-streaming)
        • Create chat image recognition (streaming)
        • Create chat image recognition (streaming) base64
        • Create chat image recognition (non-streaming)
        • Function calling
        • N choices
        • Create chat function call (only non-streaming)
        • Create structured output
      • ChatGPT (Completions)
        • Completion object
        • Creation completed
      • ChatGPT(Embeddings)
        • Embedded Object
        • Create embed
    • Anthropic Claude
      • Offical Format
        • Messages (official Anthropic format)
        • Messages(Image Recognition)
        • Messages(function call)
        • Messages(Web search)
      • Create chat completion (streaming)
      • Create chat completion (non-streaming)
      • Create chat image recognition (streaming)
      • Create chat image recognition (non-streaming)
    • Gemini
      • Gemini Image creation interface (gemini-2.0-flash-exp-image-generation)
        POST
      • Chat interface
        POST
      • Image recognition interface
        POST
      • Function calling - Google Search
        POST
      • Function calling - codeExecution
        POST
  • Image Models
    • GPT-IMAGE-1
      • Generate Image by gpt-image-1
      • Edit Image by gpt-image-1
    • MJ
      • Submit Imagine task (mj_imagine)
      • Submit Blend task (mj_blend)
      • Submit Describe task (mj_describe)
      • Submit Change task (mj_variation, mj_upscale,mj_reroll)
      • Query task status based on task ID
    • Ideogram
      • Generate with Ideogram 3.0
      • Edit with Ideogram 3.0
      • Remix with Ideogram 3.0
      • Ideogram Upscale
    • Kling Image
      • Submit Image Generation
      • Get Image by Task ID
      • Submit Kolors Virtual Try On
      • Get Kolors Virtual Try On by Task ID
    • Flux
      • Flux on Replicate
        • Submit Image by flux-kontext-pro
        • Submit Image by flux-kontext-max
        • Submit Image by flux-pro
        • Submit Image by flux-pro-1.1-ultra
        • Get Image by ID
    • Recraft API
      • Recraft Image
      • Generate Image
      • Generate Vector Image
      • Remove Background
      • Clarity Upscale
      • Generative Upscale
    • Models use Dall-e Format
      • Google Imagen
      • Bytedance - seedream-3.0
      • Recraftv3 use Dall-e endpoint
      • Flux use Dall-e endpoint
    • Google Imagen
      • Google/imagen-4 on Replicate
      • Get Imagen 4 Task
    • DALL·E 3
      POST
  • Video Models
    • Kling Video
      • Create Video by Text
      • Get Video by Task ID(text2video)
      • Create Video by Image
      • Get Video by Task ID(image2video)
    • Runway ML Video
      • Create Video by Runway
      • Get Video by Task ID
    • Luma Video
      • Create Video by Luma
      • Get Video by Task ID
    • Pika Video
      • Create Video by Pika
      • Get Video by Task ID
    • Google Veo
      • Submit Video Request
      • Submit Video Request with Frames
      • Get Video by ID
    • Minimax - Hailuo
      • Submit Video Request
      • Get Video
    • Seedance
      • Submit Video Request
      • Get Video by Task ID
    • Mj Video
      • Submit Mj Video Request
      • Get Mj Video by task id
  • FAL-AI Models
    • Images Models
      • Ideogram/v3/remix
      • Flux-pro/kontext/max
      • Fal-recraft-v3-text-to-image
      • Fal-recraft-v3-image-to-image
      • Fal-bytedance-seededit-v3-edit-image
    • Audio Models
      • Minimax/speech-02-hd
      • Minimax/speech-02-turbo
      • Elevenlabs/tts/turbo-v2.5
      • Elevenlabs/tts/multilingual-v2
    • Video Models
      • Topaz/upscale/video
      • Luma-dream-machine/ray-2-flash/reframe
      • Luma-dream-machine/ray-2/reframe
    • Get FAL-AI tasks
  • Music Model - Suno
    • Illustrate
    • Parameter
    • Task submission
      • Generate songs (inspiration, customization, continuation)
      • Generate lyrics
    • Query interface
      • Query a single task
  • Python Samples
    • python openai official library (using AutoGPT, langchain, etc.)
    • Python uses speech to text
    • Python uses text to speech
    • Python uses Embeddings
    • python calls DALL·E
    • python simple call openai function-calling demo
    • python langchain
    • python llama_index
    • Python uses gpt-4o to identify pictures-local pictures
    • python library streaming output
    • Python uses gpt-4o to identify images
  • Plug-in/software usage tutorials
    • Setting HTTP for Make.com with Yescale
    • Sample Code for gpt-4o-audio/gpt-4o-mini-audio
  • Help Center
    • HTTP status codes
  • Tutorials
    • GPT-Image-1 API: A Step-by-Step Guide With Examples
    • Claude Code via YEScale API
    • Task Sync Endpoint Usage Guide
  1. Gemini

Function calling - Google Search

POST
/v1/chat/completions
Use Google Search Grouding

Request

Header Params

Body Params application/json

Example
{
  "model": "gemini-2.5-flash-preview-05-20",
  "messages": [
    {
      "role": "user",
      "content": "Giá vàng hôm nay."
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "googleSearch"
      }
    }
  ],
  "tool_choice": "auto"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gemini-2.5-flash-preview-05-20",
  "messages": [
    {
      "role": "user",
      "content": "Giá vàng hôm nay."
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "googleSearch"
      }
    }
  ],
  "tool_choice": "auto"
}'

Responses

🟢200OK
application/json
Body

Example
{
    "id": "chatcmpl-413149122b27455faf6c96eed8fedf2d",
    "model": "gemini-2.5-flash-preview-05-20",
    "object": "chat.completion",
    "created": 1748165169,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Giá vàng trong nước và thế giới ngày 25/5/2025 đang có nhiều biến động tăng mạnh.\n\n**Tại thị trường trong nước (cập nhật lúc 9h30 ngày 25/5):**\n\n*   **Vàng miếng SJC:**\n    *   Công ty Vàng bạc đá quý Sài Gòn (SJC) niêm yết giá vàng miếng SJC mua vào - bán ra ở mức 119 - 121 triệu đồng/lượng. Chênh lệch mua-bán là 2 triệu đồng/lượng.\n    *   Giá vàng miếng SJC chốt tuần ở mức 121 triệu đồng/lượng.\n    *   Giá vàng miếng DOJI tại Hà Nội và Thành phố Hồ Chí Minh mua vào ở mức 119 triệu đồng/lượng và bán ra 121 triệu đồng/lượng.\n    *   Giá vàng miếng SJC đã tăng 3,5 triệu đồng ở chiều mua vào và 2,5 triệu đồng (bán ra) so với cuối tuần trước.\n*   **Vàng nhẫn SJC 9999:**\n    *   SJC niêm yết giá vàng nhẫn SJC 9999 mua vào 113,5 triệu đồng/lượng, bán ra 116 triệu đồng/lượng.\n    *   Giá vàng nhẫn SJC tăng 1 triệu đồng chiều mua và 500.000 đồng chiều bán lên lần lượt 113,5 triệu đồng/lượng và 116 triệu đồng/lượng.\n    *   Vàng PNJ hiện mua vào ở mức 113 triệu đồng/lượng và bán ra mức 116 triệu đồng/lượng.\n\n**Giá vàng thế giới (cập nhật lúc 15:40:00 ngày 25/05/2025):**\n\n*   Giá vàng thế giới giao dịch ở mức 3.356 USD/ounce.\n*   Giá vàng quốc tế (XAU) hôm nay là 3.357,40 USD/Ounce, tăng 1.82% trong 24 giờ qua, tương ứng tăng 60.03 USD/Ounce.\n*   Quy đổi theo tỷ giá Vietcombank, 1 Ounce vàng thế giới tương đương 87.728.862 VNĐ.\n*   1 cây vàng theo giá vàng thế giới quy đổi sang tiền Việt Nam Đồng có giá là 105.770.568 VNĐ.\n\nGiá vàng thế giới tăng mạnh do nhà đầu tư đổ dồn vào vàng như một tài sản trú ẩn an toàn trước những động thái cứng rắn về thuế quan của Tổng thống Mỹ Donald Trump và lo ngại về độ tin cậy của đồng USD và trái phiếu Mỹ."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 6,
        "completion_tokens": 738,
        "total_tokens": 744,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "text_tokens": 0,
            "audio_tokens": 0,
            "image_tokens": 0
        },
        "completion_tokens_details": {
            "text_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 44
        },
        "input_tokens": 0,
        "output_tokens": 0,
        "input_tokens_details": null
    }
}
Modified at 2025-05-25 09:34:39
Previous
Image recognition interface
Next
Function calling - codeExecution
Built with