Source: https://ailoot.ai/models/vi/gemini-3-pro-preview/
Canonical: https://ailoot.ai/models/vi/gemini-3-pro-preview/
Language: vi

# gemini-3-pro-preview

[Markdown](https://ailoot.ai/models/vi/gemini-3-pro-preview/index.md) · [JSON](https://ailoot.ai/models/vi/gemini-3-pro-preview/facts.json)

## [gemini-3-pro-preview](https://ailoot.ai/models/vi/gemini-3-pro-preview/)

Gemini 3 Pro Preview là mô hình suy luận đa phương thức của Google, nhận văn bản, hình ảnh, âm thanh, video và PDF, rồi xuất văn bản. Ngân sách đầu vào lớn, khả năng lập trình và quy trình công cụ được hỗ trợ phù hợp với phân tích chi tiết, so sánh tài liệu và thực hiện tác vụ dựa trên bằng chứng.

- [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `gemini-3-pro-preview`](https://ailoot.ai/models/vi/gemini-3-pro-preview/#method-0)
- [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `gemini-3-pro-preview`](https://ailoot.ai/models/vi/gemini-3-pro-preview/#method-1)

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

Gemini 3 Pro Preview là biến thể xem trước Gemini 3 Pro được Google đặt tên, dành cho suy luận đa phương thức và sinh văn bản. Mô hình có thể xử lý văn bản, hình ảnh, âm thanh, video cùng tài liệu PDF và trả về kết quả bằng văn bản. Các mục đích sử dụng gồm phân tích phức tạp, lập trình nâng cao, phát triển thuật toán và tác vụ kết hợp tập nguồn lớn với một câu hỏi cụ thể.

#### Cấu trúc mô hình và đầu vào

Gemini 3 Pro là mô hình hỗn hợp chuyên gia thưa dựa trên transformer, hỗ trợ đầu vào đa phương thức ngay trong thiết kế. Kiến trúc chuyển mỗi token qua một tập con chuyên gia được chọn. Đây là đặc điểm thiết kế mô hình, không phải điều khiển để người dùng chọn một chuyên gia cụ thể hoặc cố định cấu hình phục vụ.

Chuẩn bị đầu vào theo nhu cầu thông tin của tác vụ. Tài liệu, ảnh chụp màn hình và bản ghi âm có thể cung cấp các bằng chứng khác nhau. Nêu rõ từng tư liệu chứa gì và đóng góp thế nào cho câu trả lời. Đầu ra vẫn là văn bản; khả năng hiểu tư liệu hình ảnh hoặc lời nói không biến bản xem trước này thành trình tạo ảnh, giọng nói hay video.

#### Phân tích đa phương thức

Dùng hình ảnh cho câu hỏi về nội dung nhìn thấy, âm thanh cho lời nói hoặc thông tin âm học, và video cho chuỗi diễn biến mà thay đổi theo thời gian có ý nghĩa. Gửi tư liệu thực tế cùng câu hỏi thay vì chỉ mô tả theo trí nhớ. Khi so sánh nhiều tư liệu, gắn nhãn rõ ràng để câu trả lời dẫn đúng nguồn.

Ví dụ, yêu cầu phân tích sản phẩm có thể kết hợp đặc tả bằng văn bản, ảnh chụp giao diện và bản ghi trình diễn. Yêu cầu so sánh, phân biệt điều đặc tả cam kết với những gì nhìn hoặc nghe được trong tư liệu đã cung cấp. Xác định kết quả mong muốn gồm phát hiện, quan sát hỗ trợ và câu hỏi chưa được giải đáp.

Với tác vụ PDF, cung cấp tài liệu và chỉ rõ những phần hoặc nhận định cần xem xét. Câu hỏi hữu ích yêu cầu so sánh, trích xuất hoặc giải thích gắn với nguồn, thay vì chỉ đòi tóm tắt chung một tệp lớn.

#### Ngữ cảnh dài và ngân sách đầu ra

Đặc tả chính xác của bản xem trước ghi giới hạn đầu vào 1.048.576 token và đầu ra 65.536 token. Nhà sản xuất nêu mốc kiến thức tháng 1 năm 2025; cung cấp bằng chứng mới hơn khi câu hỏi phụ thuộc vào sự kiện hoặc thông tin sau mốc đó. Đây là hai ngân sách khác nhau. Có thể đọc tập nguồn lớn để trả lời tập trung mà không cần mô hình tái hiện mọi phần của đầu vào.

Tổ chức tài liệu dài với cấu trúc rõ ràng: tên tài liệu, ranh giới các phần, đường dẫn mã và câu hỏi mà đầu ra phải trả lời. Đặt ngoại lệ và định nghĩa liên quan gần nội dung mà chúng bổ nghĩa. Nếu tác vụ cần báo cáo dài, nêu các phần của báo cáo và bằng chứng mong đợi trong từng phần.

Cửa sổ ngữ cảnh lớn không bảo đảm mọi chi tiết được chú ý như nhau hoặc mọi kết luận đều đúng. Google cũng chỉ ra khả năng suy giảm trong hội thoại nhiều lượt; rà soát dữ kiện nguồn quan trọng và ngữ cảnh tái sử dụng khi trao đổi phát triển. Đối chiếu câu trả lời với những đoạn hoặc tư liệu cụ thể hỗ trợ các nhận định quan trọng.

#### Lập trình và phát triển thuật toán

Các mục đích nhà sản xuất nêu gồm lập trình nâng cao và công việc thuật toán. Cung cấp mã liên quan, giả định về môi trường, lỗi quan sát được và hành vi mong đợi. Với bài toán thuật toán, xác định đầu vào, đầu ra mong muốn và điều kiện như thứ tự, bản trùng hoặc dữ liệu không hợp lệ.

Yêu cầu gỡ lỗi hữu ích đặt đầu vào gây lỗi và thông báo lỗi cạnh vùng mã liên quan nhỏ nhất. Yêu cầu chẩn đoán và thay đổi có trọng tâm, rồi xem thay đổi đề xuất có giải quyết hành vi đã báo cáo không. Mã được sinh và khẳng định rằng mã sẽ chạy khác với triển khai đã thực thi và xác minh.

Với câu hỏi về kho mã lớn hơn, dùng ngân sách đầu vào để cung cấp các tệp cần thiết kèm nhãn đường dẫn rõ ràng. Nêu sản phẩm cần nhận là lời giải thích, bản vá đề xuất hay phân tích các phương án để kết quả có mục đích cụ thể.

#### Công cụ, nguồn và kết quả có cấu trúc

Đặc tả của nhà sản xuất cho bản xem trước hỗ trợ lời gọi hàm, thực thi mã, tìm kiếm tệp, đối chiếu nguồn qua tìm kiếm và ngữ cảnh URL. Các tính năng có vai trò khác nhau. Lời gọi hàm mô tả thao tác để ứng dụng thực hiện; kết quả công cụ sau đó cung cấp bằng chứng cho bước mô hình tiếp theo. Thực thi mã là một quy trình công cụ, không phải bảo đảm mọi mã ứng dụng được sinh đã được kiểm thử.

Đối chiếu nguồn qua tìm kiếm và ngữ cảnh URL cung cấp quy trình làm việc dựa trên nguồn, còn tìm kiếm tệp làm việc với tập tệp đã chuẩn bị. Giữ kết quả công cụ cùng liên kết nguồn với câu trả lời để có thể xem xét kết luận. Theo đặc tả, biến thể này không hỗ trợ điều khiển máy tính hoặc đối chiếu nguồn qua Maps.

Hỗ trợ đầu ra có cấu trúc có thể biểu diễn kết quả theo lược đồ xác định. Nêu các trường và ý nghĩa trước khi sinh, rồi rà soát cả nội dung lẫn định dạng. Đối tượng có cấu trúc hợp lệ vẫn cần kiểm tra dữ kiện và yêu cầu riêng của tác vụ.

#### Suy luận, tái sử dụng và ranh giới phiên bản

Bản xem trước này hỗ trợ tư duy. Dùng tác vụ rõ ràng, bằng chứng liên quan và ràng buộc cụ thể cho công việc cần nhiều bước suy luận. Kết quả cần giải thích giả định cùng kết luận hữu ích; suy luận ẩn hoặc sự tồn tại của chế độ tư duy tự nó không phải xác minh.

Nhà sản xuất cũng liệt kê hỗ trợ bộ nhớ đệm và xử lý theo lô. Đây là những tính năng xử lý tách biệt với khả năng nội dung của mô hình; sự hiện diện của chúng không chứng minh một yêu cầu cụ thể được lưu đệm hoặc kết quả theo lô là đúng.

Phân biệt Gemini 3 Pro Preview với Gemini 3.1 Pro Preview, Gemini 3 Pro Image và các biến thể âm thanh hoặc Live. Đầu ra của bản xem trước này là văn bản, và đặc tả không bao gồm tạo ảnh, tạo âm thanh hay hoạt động Live. Đánh giá câu trả lời, mã hoặc kết quả có cấu trúc trả về theo tập nguồn đã cung cấp và tác vụ dự định.

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

[`gemini-3-pro-preview`](https://ailoot.ai/models/vi/#m=gemini-3-pro-preview&route=Ultra&caller=gemini-3-pro-preview&fmt=chat)

Khác /`gemini-3-pro-preview`

### Bắt đầu

Gemini 3 Pro Preview là mô hình suy luận đa phương thức của Google, nhận văn bản, hình ảnh, âm thanh, video và PDF, rồi xuất văn bản. Ngân sách đầu vào lớn, khả năng lập trình và quy trình công cụ được hỗ trợ phù hợp với phân tích chi tiết, so sánh tài liệu và thực hiện tác vụ dựa trên bằng chứng.

Đầu vào được chấp nhận

Văn bản

Kết quả

Văn bản

### Có trên Ailoot · đầu vào & phương thức

**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions`

Đầu vào

`text`

Đầu ra

`text`

Định dạng đầu ra

json hoặc SSE

| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
| --- | --- | --- | --- | --- |
| Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn gemini-3-pro-preview | Mặc định— |
| Trường`messages` | Loại`message[]` | Yêu cầuBắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 | Mặc định— |
| Trường`messages[].role` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— |
| Trường`messages[].content` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Áp dụng khi: Hội thoại văn bản | Mặc định— |
| Trường`stream` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhfalse |

Tổ hợp tư liệu đầu vào

**Văn bản** · Văn bản UTF8

`messages[].content`

Tham số phương thức và vòng đời

| Tham số | Hợp đồng |
| --- | --- |
| Tham số`content_type` | Hợp đồngapplication/json |
| Tham số`required` | Hợp đồngmodel, messages |
| Tham số`material_types` | Hợp đồngtext |
| Tham số`messages` | Hợp đồngMảng thông điệp có cấu trúc role/content |
| Tham số`file_material` | Hợp đồngTài liệu UTF-8 thực tế được chèn nguyên dạng văn bản; không suy ra ID tệp |
| Tham số`optional_controls` | Hợp đồngstream |
| Tham số`control_scope` | Hợp đồngHội thoại văn bản; stream là giá trị boolean và mặc định là false. |
| Tham số`output_modalities` | Hợp đồngtext |
| Tham số`hosted_operations` | Hợp đồngfalse |
| Tham số`multimodal_input_binding` | Hợp đồngnull |

Bí danh phương thức: `/chat/completions`

Vòng đời: `synchronous_or_streamed`

Gửi ID mô hình chính xác cùng messages.

Độ dài ngữ cảnh không phải giới hạn đầu ra.

Tệp văn bản có thể cung cấp nguyên văn nội dung; đầu vào hình ảnh, âm thanh hoặc đối tượng tệp cần có liên kết chính xác.

### Bảng giá

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh

Chưa chỉ định Khi chọn chế độ nhanh

Chế độ Flex

Chưa chỉ định Khi chọn chế độ flex

Mức độ suy luận tối đa

Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Giá lưu đệm tường minh

Chưa bật Khi yêu cầu lưu đệm tường minh

#### Mức phí Ailoot

#### Giá theo cấu hình

| Cấu hình | Biểu mức phí | Phí |
| --- | --- | --- |
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Phí Đầu vào · Token đầu vào **$0.004** / 1K token Đầu ra · Token đầu ra **$0.024** / 1K token Đầu vào · Đọc bộ nhớ đệm **$0** / 1K token Đầu vào · Ghi bộ nhớ đệm **$0** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ **—** / 1K token |

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/)

### Ví dụ yêu cầu

#### Ailoot Ultra · OpenAI Chat

curlPython SDK

```bash
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
```

```python
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"))
```

### Nhận và lưu kết quả

#### Ailoot Ultra · OpenAI Chat

json hoặc SSE

##### Lưu tất cả kết quả đã hoàn tất

Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.

Giữ mọi phương án trả lời cùng nội dung, lệnh gọi công cụ và dữ liệu suy luận của phương án đó. Với SSE, ghép các phần thay đổi theo chỉ số phương án và công cụ, giữ lý do kết thúc cuối cùng cùng dữ liệu sử dụng.

##### Nếu cần kiểm tra phản hồi gốc

Giữ ID và header của yêu cầu, phản hồi. Không cung cấp URL chung để truy xuất tác vụ văn bản.

Trường phản hồi

| Trường | Loại |
| --- | --- |
| Trường`choices[].index` | Loạiinteger |
| Trường`choices[].message.content` | Loạistring\|null |
| Trường`choices[].message.tool_calls` | Loạitool\_call\[\] |
| Trường`choices[].message.reasoning_content` | Loạistring |
| Trường`choices[].message.reasoning_details` | Loạiobject\|array |
| Trường`choices[].finish_reason` | Loạistring\|null |
| Trường`usage` | Loạiobject |

Lỗi và bước tiếp theo

| Phản hồi | Điều kiện | Bước tiếp theo |
| --- | --- | --- |
| Phản hồi400 · `invalid_request_error` | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |

### Bí danh

#### Bí danh mô hình

**Ailoot Ultra** [`gemini-3-pro-preview`](https://ailoot.ai/models/vi/#m=gemini-3-pro-preview&route=Ultra&caller=gemini-3-pro-preview&fmt=chat)

#### Bí danh đường dẫn phương thức

`/chat/completions`

#### ID gọi liên quan

[`gemini-3-pro-preview`](https://ailoot.ai/models/vi/#m=gemini-3-pro-preview&route=Ultra&caller=gemini-3-pro-preview&fmt=chat)

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

[`gemini-3-pro-preview`](https://ailoot.ai/models/vi/#m=gemini-3-pro-preview&route=Ultra&caller=gemini-3-pro-preview&fmt=messages)

Khác /`gemini-3-pro-preview`

### Bắt đầu

Gemini 3 Pro Preview là mô hình suy luận đa phương thức của Google, nhận văn bản, hình ảnh, âm thanh, video và PDF, rồi xuất văn bản. Ngân sách đầu vào lớn, khả năng lập trình và quy trình công cụ được hỗ trợ phù hợp với phân tích chi tiết, so sánh tài liệu và thực hiện tác vụ dựa trên bằng chứng.

Đầu vào được chấp nhận

Văn bản

Kết quả

json · sse

### Có trên Ailoot · đầu vào & phương thức

**Ailoot Ultra · Anthropic Messages** `POST /v1/messages`

Đầu vào

`text`

Đầu ra

`json`, `sse`

Định dạng đầu ra

JSON hoặc SSE

| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
| --- | --- | --- | --- | --- |
| Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn gemini-3-pro-preview | Mặc định— |
| Trường`messages` | Loại`message[]` | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`messages[].role` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn user, assistant | Mặc định— |
| Trường`messages[].content` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`max_tokens` | Loại`integer` | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`stream` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhfalse |

Tổ hợp tư liệu đầu vào

**Văn bản** · Văn bản UTF-8

`Chuỗi messages[].content`

Tham số phương thức và vòng đời

| Tham số | Hợp đồng |
| --- | --- |
| Tham số`content_type` | Hợp đồngapplication/json |
| Tham số`required` | Hợp đồngmodel, messages, max\_tokens |
| Tham số`optional_controls` | Hợp đồngstream |
| Tham số`material_types` | Hợp đồngtext |
| Tham số`text_file_material` | Hợp đồngĐọc tài liệu UTF-8 thực tế và đặt nội dung văn bản vào chuỗi đầu vào hoặc nội dung thông điệp được chỉ định. |

Vòng đời: `synchronous_or_streamed`

### Bảng giá

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh

Chưa chỉ định Khi chọn chế độ nhanh

Chế độ Flex

Chưa chỉ định Khi chọn chế độ flex

Mức độ suy luận tối đa

Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Giá lưu đệm tường minh

Chưa bật Khi yêu cầu lưu đệm tường minh

#### Mức phí Ailoot

#### Giá theo cấu hình

| Cấu hình | Biểu mức phí | Phí |
| --- | --- | --- |
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Phí Đầu vào · Token đầu vào **$0.004** / 1K token Đầu ra · Token đầu ra **$0.024** / 1K token Đầu vào · Đọc bộ nhớ đệm **$0** / 1K token Đầu vào · Ghi bộ nhớ đệm **$0** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ **—** / 1K token |

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/)

### Ví dụ yêu cầu

#### Ailoot Ultra · Anthropic Messages

Nội dung yêu cầu JSON tối thiểu, đầy đủcurl · dùng tài liệu UTF-8 của bạnPython · lưu kết quả đầy đủ

```json
{
  "model": "gemini-3-pro-preview",
  "max_tokens": 128,
  "messages": [
    {
      "role": "user",
      "content": "Summarize the incident report."
    }
  ],
  "stream": false
}
```

```bash
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
```

```python
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))
```

### Nhận và lưu kết quả

#### Ailoot Ultra · Anthropic Messages

JSON hoặc SSE

##### Lưu tất cả kết quả đã hoàn tất

Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.

Giữ mọi khối nội dung, chữ ký suy nghĩ và ID sử dụng công cụ thực tế. Ghép tất cả các phần thay đổi của khối SSE; khối văn bản đầu tiên không phải toàn bộ đầu ra.

##### Nếu cần kiểm tra phản hồi gốc

Giữ ID và header của yêu cầu, phản hồi. Không cung cấp URL chung để truy xuất tác vụ văn bản.

Trường phản hồi

| Trường | Loại |
| --- | --- |
| Trường`id` | Loạistring |
| Trường`model` | Loạistring |
| Trường`content[]` | Loạitext\|thinking\|tool\_use\|other content block |
| Trường`stop_reason` | Loạistring\|null |
| Trường`usage` | Loạiobject |

Lỗi và bước tiếp theo

| Phản hồi | Điều kiện | Bước tiếp theo |
| --- | --- | --- |
| Phản hồi400 · `invalid_request_error` | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |

### Bí danh

#### Bí danh mô hình

**Ailoot Ultra** [`gemini-3-pro-preview`](https://ailoot.ai/models/vi/#m=gemini-3-pro-preview&route=Ultra&caller=gemini-3-pro-preview&fmt=messages)

#### Bí danh đường dẫn phương thức

`/chat/completions`

#### ID gọi liên quan

[`gemini-3-pro-preview`](https://ailoot.ai/models/vi/#m=gemini-3-pro-preview&route=Ultra&caller=gemini-3-pro-preview&fmt=messages)

FAQ · gemini-3-pro-preview

Có những đầu vào và kết quả nào?

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

Yêu cầu sử dụng những trường nào?

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

Áp dụng những giới hạn nào?

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

Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn.

## Công ty và danh mục dự án của công ty

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

## Mua token với giá ưu đãi.

Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token.

Thuê bao

Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn.

Mã giảm đến 50%

Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng.

Chi phí trong lịch sử

Mô hình, token và số tiền được lưu cho mỗi yêu cầu.

[Chọn gói thuê bao](https://ailoot.ai/docs/vi/billing/subscriptions/) · [Xem giá mô hình](https://ailoot.ai/models/vi/)

## Kết nối API vào sản phẩm bạn đang bán.

SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại.

Ứng dụng thương mại

Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ.

Giấy phép bán lại

Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản.

Tài liệu trên website

Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối.

[Yêu cầu giấy phép bán lại](mailto:support@ailoot.ai) · [Đề nghị giao kết và thỏa thuận cấp phép](https://ailoot.ai/legal/offer?lang=vi)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.