models

gemini-3-pro-preview

Markdown · JSON

gemini-3-pro-preview

Gemini 3 Pro Preview is Google's multimodal reasoning model for text, images, audio, video and PDFs, with text output. Its large input allowance, coding capabilities and supported tool workflows suit detailed analysis, document comparison and evidence-based task execution.

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

Gemini 3 Pro Preview is Google's named Gemini 3 Pro preview profile for multimodal reasoning and text generation. It can work with text, images, audio, video and PDF documents and return a written result. The intended uses include complex analysis, advanced coding, algorithm development and tasks that combine a substantial source set with a specific question.

Model and input structure

Gemini 3 Pro is a transformer-based sparse mixture-of-experts model with native multimodal input support. Its architecture routes each token through a selected subset of experts. This is a model-design distinction, rather than a user control for selecting a particular expert or fixing a serving configuration.

Prepare inputs around the task's information need. A document, screenshot and audio recording can each supply different evidence. Identify what each asset contains and how it should contribute to the answer. The output remains text; understanding visual or spoken material does not make this preview an image, speech or video generator.

Multimodal analysis

Use images for questions about visible content, audio for spoken or acoustic information and video for a sequence whose changes matter over time. Keep the actual asset with the question rather than describing it only from memory. When comparing several assets, label them clearly so that the answer can refer to the right source.

For example, a product-analysis brief can combine a written specification, a screenshot of the interface and a recorded demonstration. Ask for a comparison that separates what the specification promises from what is visible or audible in the supplied material. Define the desired result as findings, supporting observations and unresolved questions.

For a PDF task, provide the document and identify the sections or claims to examine. A useful question asks for a comparison, extraction or explanation tied to the source, instead of only requesting a general summary of a large file.

Long context and the output allowance

The exact preview specification lists an input limit of 1,048,576 tokens and an output limit of 65,536 tokens. The maker gives a January 2025 knowledge cutoff; supply newer evidence when the question depends on later events or information. These are different allowances. A large source set can be read for a focused answer without requiring the model to reproduce every part of the input.

Organize long material so that its structure is clear: document titles, section boundaries, code paths and the question that the output must answer. Keep relevant exceptions and definitions close to the content they qualify. If a task needs a long report, specify the report's sections and the evidence expected in each one.

A large context window does not guarantee that every detail will receive equal attention or that every conclusion will be correct. Google also identifies possible degradation across multi-turn conversations; review important source facts and reused context as an exchange develops. Review the answer against the particular passages or assets that support its important claims.

Coding and algorithm development

The producer's intended uses include advanced coding and algorithmic work. Supply the relevant source, environment assumptions, observed failure and expected behavior. For an algorithm task, define the input, desired output and conditions such as ordering, duplicates or invalid data.

A useful debugging brief pairs the failing input and error with the smallest relevant source region. Ask for a diagnosis and a focused change, then inspect whether the proposed change addresses the reported behavior. Generated code and a claim that it should work are different from an implementation that has been run and verified.

For a larger repository question, use the input allowance to supply the necessary files with clear path labels. State whether the desired artifact is an explanation, a proposed patch or an analysis of alternatives so that the result has a concrete purpose.

Tools, sources and structured results

The preview's producer specification supports function calling, code execution, file search, search grounding and URL context. These features have distinct roles. A function call describes an operation for an application to execute; a tool result then supplies evidence for the following model step. Code execution is a tool workflow, rather than a guarantee that arbitrary generated application code has already been tested.

Search grounding and URL context provide source-oriented workflows, while file search works with a prepared file collection. Keep tool results and source associations with the answer so that a conclusion can be inspected. The profile does not support computer use or Maps grounding according to its specification.

Structured output support can express a result in a defined schema. Specify the fields and their meaning before generation, and review the contents as well as the format. A valid structured object still needs factual and task-specific checking.

Reasoning, reuse and edition boundaries

Thinking is supported for this preview. Use a clear task, relevant evidence and explicit constraints for work that requires several reasoning steps. The result should explain assumptions and the useful conclusion; hidden reasoning or the existence of a thinking mode is not itself verification.

The producer also lists caching and batch support. These are processing features separate from the model's content capabilities, and their presence does not establish that a particular request was cached or that a batch result is correct.

Keep Gemini 3 Pro Preview separate from Gemini 3.1 Pro Preview, Gemini 3 Pro Image and the audio or Live profiles. This preview's output is text, and its specification does not include image generation, audio generation or Live operation. Evaluate the returned answer, code or structured result against the supplied source set and intended task.

Ailoot Ultra · OpenAI Chat POST /v1/chat/completions gemini-3-pro-preview

gemini-3-pro-preview

Other /gemini-3-pro-preview

Overview

Gemini 3 Pro Preview is Google's multimodal reasoning model for text, images, audio, video and PDFs, with text output. Its large input allowance, coding capabilities and supported tool workflows suit detailed analysis, document comparison and evidence-based task execution.

Accepted inputs
Text
Results
Text

Available in Ailoot · inputs & methods

Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
Input types
text
Output types
text
Output format
json or SSE
FieldTypeRequirementValues & limitsDefault
FieldmodelTypestringRequirementRequiredValues & limits
gemini-3-pro-preview
Default—
FieldmessagesTypemessage[]RequirementRequiredValues & limits
Minimum items: 1
Default—
Fieldmessages[].roleTypestringRequirementRequiredValues & limits
Model-specific
Default—
Fieldmessages[].contentTypestringRequirementOptionalValues & limits
Applies when: Text conversation
Default—
FieldstreamTypebooleanRequirementOptionalValues & limitsDefaultfalse
Input material combinations

Text · UTF8 text

messages[].content

Method parameters and lifecycle
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, messages
Parametermaterial_typesContracttext
ParametermessagesContractmessage array with role/content shape
Parameterfile_materialContractactual UTF-8 document inserted as literal text; no file ID inferred
Parameteroptional_controlsContractstream
Parametercontrol_scopeContractText conversation; stream is a boolean and defaults to false.
Parameteroutput_modalitiesContracttext
Parameterhosted_operationsContractfalse
Parametermultimodal_input_bindingContractnull

Method aliases: /chat/completions

Lifecycle: synchronous_or_streamed

Send exact model ID with messages.

Context length is not an output cap.

A text file may supply literal text; image/audio/file-object inputs need exact binding.

Pricing

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode
Not specified When fast mode is selected
Flex mode
Not specified When flex mode is selected
Maximum reasoning effort
Not specified When maximum reasoning effort uses the default adjustment
Explicit cache pricing
Not enabled When explicit cache is requested

Ailoot rates

Prices by configuration

ConfigurationRate scheduleCharge
ConfigurationBase token ratesRate scheduleBase rateCharge
Input · Input tokens $0.004 / 1K tokens
Output · Output tokens $0.024 / 1K tokens
Input · Cache read $0 / 1K tokens
Input · Cache write $0 / 1K tokens
Input · Cache write, 1 hour — / 1K tokens

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →

Example requests

Ailoot Ultra · OpenAI Chat

curlPython SDK
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"gemini-3-pro-preview","messages":[{"role":"user","content":"hello"}],"stream":false}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("choices",[]):
    if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os

if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model="gemini-3-pro-preview", messages=[{"role":"user","content":"hello"}], stream=False)
import base64, json
from pathlib import Path

def save_result(data, stem="result"):
    # Keep every field, including usage, IDs, reasoning and tool requests.
    Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
    print(json.dumps(data, ensure_ascii=False, indent=2))
    def save_blob(encoded, suffix, label):
        raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
        ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
        file = Path(stem + "-" + label + "." + ext)
        file.write_bytes(raw)
        print("Saved", file)
    for index, block in enumerate(data.get("content") or []):
        print("Content", index, json.dumps(block, ensure_ascii=False))
    for choice in data.get("choices") or []:
        print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
    for index, item in enumerate(data.get("output") or []):
        print("Output", index, json.dumps(item, ensure_ascii=False))
        if item.get("type") == "image_generation_call" and item.get("result"):
            save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
    for ci, candidate in enumerate(data.get("candidates") or []):
        for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
            print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
            blob = part.get("inlineData") or part.get("inline_data")
            if blob and blob.get("data"):
                mime = blob.get("mimeType") or blob.get("mime_type")
                suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
                save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))

save_result(result.to_dict(mode="json"))

Receive and save results

Ailoot Ultra · OpenAI Chat

json or SSE

Keep all completed results

Keep every complete returned response, file and content part.

Keep every choice and its content/tool calls/reasoning. In SSE assemble deltas by choice/tool index, retain the final finish reason and usage.

If the original response needs checking

Keep request/response IDs and headers. No generic text job retrieval URL is supplied.

Response fields
FieldType
Fieldchoices[].indexTypeinteger
Fieldchoices[].message.contentTypestring|null
Fieldchoices[].message.tool_callsTypetool_call[]
Fieldchoices[].message.reasoning_contentTypestring
Fieldchoices[].message.reasoning_detailsTypeobject|array
Fieldchoices[].finish_reasonTypestring|null
FieldusageTypeobject
Errors and next steps
ResponseConditionNext step
Response400 · invalid_request_errorConditionInvalid required fields, material representation or parameter valueNext stepCorrect the indicated fields before a new creation request.

Aliases

Model aliases

Ailoot Ultra gemini-3-pro-preview

Method path aliases

/chat/completions

Related caller IDs

gemini-3-pro-preview

Ailoot Ultra · Anthropic Messages POST /v1/messages gemini-3-pro-preview

gemini-3-pro-preview

Other /gemini-3-pro-preview

Overview

Gemini 3 Pro Preview is Google's multimodal reasoning model for text, images, audio, video and PDFs, with text output. Its large input allowance, coding capabilities and supported tool workflows suit detailed analysis, document comparison and evidence-based task execution.

Accepted inputs
Text
Results
json · sse

Available in Ailoot · inputs & methods

Ailoot Ultra · Anthropic Messages POST /v1/messages
Input types
text
Output types
json, sse
Output format
JSON or SSE
FieldTypeRequirementValues & limitsDefault
FieldmodelTypestringRequirementRequiredValues & limits
gemini-3-pro-preview
Default—
FieldmessagesTypemessage[]RequirementRequiredValues & limitsDefault—
Fieldmessages[].roleTypestringRequirementRequiredValues & limits
user, assistant
Default—
Fieldmessages[].contentTypestringRequirementRequiredValues & limitsDefault—
Fieldmax_tokensTypeintegerRequirementRequiredValues & limitsDefault—
FieldstreamTypebooleanRequirementOptionalValues & limitsDefaultfalse
Input material combinations

Text · UTF-8 text

messages[].content string

Method parameters and lifecycle
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, messages, max_tokens
Parameteroptional_controlsContractstream
Parametermaterial_typesContracttext
Parametertext_file_materialContractRead the actual UTF-8 document and put its text in the indicated input or message content string.

Lifecycle: synchronous_or_streamed

Pricing

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode
Not specified When fast mode is selected
Flex mode
Not specified When flex mode is selected
Maximum reasoning effort
Not specified When maximum reasoning effort uses the default adjustment
Explicit cache pricing
Not enabled When explicit cache is requested

Ailoot rates

Prices by configuration

ConfigurationRate scheduleCharge
ConfigurationBase token ratesRate scheduleBase rateCharge
Input · Input tokens $0.004 / 1K tokens
Output · Output tokens $0.024 / 1K tokens
Input · Cache read $0 / 1K tokens
Input · Cache write $0 / 1K tokens
Input · Cache write, 1 hour — / 1K tokens

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →

Example requests

Ailoot Ultra · Anthropic Messages

Complete minimal JSON bodycurl · use your UTF-8 documentPython · save the complete result
{
  "model": "gemini-3-pro-preview",
  "max_tokens": 128,
  "messages": [
    {
      "role": "user",
      "content": "Summarize the incident report."
    }
  ],
  "stream": false
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'gemini-3-pro-preview', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'gemini-3-pro-preview', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
from urllib.request import Request, urlopen
from urllib.error import HTTPError

api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
    raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}
headers['x-api-key'] = api_key
request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
    with urlopen(request, timeout=120) as response:
        raw = response.read()
        Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
    Path('result.json').write_bytes(error.read())
    Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
    raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))

Receive and save results

Ailoot Ultra · Anthropic Messages

JSON or SSE

Keep all completed results

Keep every complete returned response, file and content part.

Keep all content blocks, thinking signatures and actual tool-use IDs. Assemble all SSE block deltas; a first text block is not the complete output.

If the original response needs checking

Keep request/response IDs and headers. No generic text job retrieval URL is supplied.

Response fields
FieldType
FieldidTypestring
FieldmodelTypestring
Fieldcontent[]Typetext|thinking|tool_use|other content block
Fieldstop_reasonTypestring|null
FieldusageTypeobject
Errors and next steps
ResponseConditionNext step
Response400 · invalid_request_errorConditionInvalid required fields, material representation or parameter valueNext stepCorrect the indicated fields before a new creation request.

Aliases

Model aliases

Ailoot Ultra gemini-3-pro-preview

Method path aliases

/chat/completions

Related caller IDs

gemini-3-pro-preview

FAQ · gemini-3-pro-preview
What inputs and results are available?

POST /v1/chat/completions · gemini-3-pro-preview: text → text

POST /v1/messages · gemini-3-pro-preview: text → json, sse

Which fields does the request use?

POST /v1/chat/completions · gemini-3-pro-preview: model, messages, stream

POST /v1/messages · gemini-3-pro-preview: model, messages, max_tokens, stream

What limits apply?

POST /v1/chat/completions · gemini-3-pro-preview: messages.min_items: 1

More details

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription
Choose a discounted plan for your regular requests.
Promo code: up to 50% off
Enter your code at checkout. The price updates to reflect the current promotion.
Spending in your history
The model, tokens and amount are recorded for each request.

Choose a subscription · View model prices

Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application
Add text, image, video and audio generation to paid features in your service.
Reseller licence
Send a description of your project and how you provide access. Request written terms for use and resale.
Documents on the website
The service offer, licence agreement and data processing policy are available before you connect.

Request a reseller licence · Service offer and licence agreement