gemini-2.0-flash (Image To Text)

POST/v1/chat/completions

Authentication

Sign up for an account
Navigate to the API Keys section in your dashboard
Generate a new API key (sk-xxxxx)
Copy and securely store your API key

Initiate Request

curl --location 'https://api.maxtoken.io/v1/chat/completions' 
--header 'Authorization: Bearer API_KEY'   
--header 'Content-Type: application/json' 
--data '{
  "model": "gemini-2.0-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is shown in this PNG image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://maxtoken.io/doc/resource/cat.png"
          }
        }
      ]
    }
  ]
}'

const axios = require('axios');
let data = JSON.stringify({
  "model": "gemini-2.0-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is shown in this PNG image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://maxtoken.io/doc/resource/cat.png"
          }
        }
      ]
    }
  ]
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.maxtoken.io/v1/chat/completions',
  headers: {
    'Authorization': 'Bearer API_KEY',
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

import requests
import json

url = "https://api.maxtoken.io/v1/chat/completions"

payload = json.dumps({
  "model": "gemini-2.0-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is shown in this PNG image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://maxtoken.io/doc/resource/cat.png"
          }
        }
      ]
    }
  ]
})
headers = {
  'Authorization': 'Bearer API_KEY',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api.maxtoken.io/v1/chat/completions"
  method := "POST"

  payload := strings.NewReader(`{
  "model": "gemini-2.0-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is shown in this PNG image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://maxtoken.io/doc/resource/cat.png"
          }
        }
      ]
    }
  ]
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer API_KEY")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Response Example

{
    "choices": [
        {
            "finish_reason": "stop",
            "index": 0,
            "message": {
                "content": "Based on the image provided, this is a technical documentation page titled **"Authentication"** for an API service called **maxtoken**. It guides developers on how to securely access and use the API.  Here is a breakdown of the specific sections contained in the file:  **1. API Key Authentication** *   It explains that the maxtoken API uses **Bearer token authentication**. *   All requests must include the API key in the header.  **2. Getting Your API Key** *   Provides a step-by-step guide:     1.  Sign up at `https://maxtoken.io/doc`.     2.  Navigate to the API Keys section in the dashboard.     3.  Generate a new key.     4.  Copy and store it securely. *   **Security Warning:** It explicitly warns users to keep keys secure, not to commit them to version control, and to rotate them regularly.  **3. Making Authenticated Requests** *   Shows how to structure the HTTP header: `x-api-key: Bearer YOUR_API_KEY`. *   Provides a **cURL** code snippet demonstrating a POST request to `https://api.maxtoken.io/v1/chat/completions` using the model "gpt-4o".  **4. Environment Variables** *   **Recommended Setup:** Advises storing keys in environment variables (e.g., `export API_KEY="..."`) rather than hardcoding them. *   **Using .env Files:** Shows a Python code example using `python-dotenv` to load credentials securely. *   **Warning:** Reminds users to add `.env` files to `.gitignore` to prevent leaking secrets.  **5. Authentication Errors** *   Lists common HTTP error codes and their JSON response formats:     *   **401 Unauthorized:** Key is missing or invalid.     *   **403 Forbidden:** Key doesn't have permission for the resource.     *   **429 Too Many Requests:** Rate limit exceeded.  **6. Best Practices** *   Lists expandable sections for maintaining security, such as "Implement Key Rotation," "Use Different Keys for Different Environments," and "Monitor Usage."  **7. API Key Management** *   **Generating New Keys:** Instructions on how to create descriptive keys via the dashboard. It notes you can only copy the key once. *   **Revoking Keys:** Steps to revoke a compromised key and update applications.  **8. Support** *   Troubleshooting tips for authentication issues. *   Provides a contact email for help: `jacoblam3219@gmail.com`.",
                "role": "assistant"
            }
        }
    ],
    "created": 1766411482,
    "id": "chatcmpl-****",
    "model": "gemini-2.5-pro",
    "object": "chat.completion",
    "usage": {
        "completion_tokens": 2051,
        "completion_tokens_details": {
            "accepted_prediction_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 1489,
            "rejected_prediction_tokens": 0
        },
        "prompt_tokens": 519,
        "prompt_tokens_details": {
            "audio_tokens": 0,
            "cached_tokens": 0
        },
        "total_tokens": 2570
    }
}

Parameters

Core Parameters

Parameter	Type	Required	Default	Range	Description
`model`	string	✅ Yes	-	-	Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of models with different capabilities, performance characteristics, and price points. Refer to the model guide to browse and compare available models.
`messages`	array	✅ Yes	-	-	A list of messages comprising the conversation so far. Depending on the model you use, different message types (modalities) are supported, like text, images, and audio.
`messages.role`	string	✅ Yes	-	`developer` `user` `system`	The role of the messages author.
`messages.name`	string	❌ No	-	-	An optional name for the participant. Provides the model information to differentiate between participants of the same role.
`messages.content`	string / array	✅ Yes	-	-	The contents of the developer message.
`messages.content.type`	string	✅ Yes	-	`text` `image_url`	The type of the content part
`messages.content.text`	string	❌ No	-	-	The text content
`messages.content.image_url`	object	❌ No	-	-	The image URL content
`messages.content.image_url.url`	string	❌ No	-	-	The URL of the image

Advanced Parameters

Parameter	Type	Required	Default	Range	Description
`max_completion_tokens`	integer / null	❌ No	-	-	An upper bound for the number of tokens that can be generated for a completion, including visible output tokens and reasoning tokens.
`stream`	boolean	❌ No	`false`	`true` `false`	Whether to stream the response back incrementally. Defaults to false.

Error Codes

Common Error Codes

Error Code	Error Name	Description
401	Unauthorized	API key is missing or invalid
403	Forbidden	Your API key doesn't have permission to access this resource, or insufficient balance for the requested operation
429	Too Many Requests	You've exceeded your rate limit
500	Internal server error	An internal server error occurred
503	Content policy violation	Content blocked due to safety concerns (actual status code is 400)

File Analysis

Text To Text