Source: https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/ Canonical: https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/ Language: vi # Qwen2.5-VL-3b [Markdown](https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/index.md) · [JSON](https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/facts.json) ## [Qwen2.5-VL-3b](https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/) Qwen2.5-VL-3B-Instruct là mô hình thị giác-ngôn ngữ nhỏ gọn được tinh chỉnh theo chỉ dẫn của Qwen cho văn bản, hình ảnh và video. Mô hình trả về văn bản và thông tin thị giác có cấu trúc, gồm trường tài liệu, tọa độ vật thể và mô tả sự kiện, với độ phân giải động và xử lý video có xét thời gian. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/#method-0) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/qwen2-5-vl-3b-instruct/#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. Giới thiệu: phiên bản 3B được tinh chỉnh theo chỉ dẫn Qwen2.5-VL-3B-Instruct là thành viên 3B của Qwen2.5-VL. Mô hình nhận chỉ dẫn văn bản với hình ảnh hoặc video và tạo phản hồi bằng văn bản, bao gồm dữ liệu có cấu trúc. Chọn mô hình cho câu hỏi thị giác xác định rõ, nhiệm vụ trích xuất tài liệu hoặc lời giải thích nối nội dung nhìn thấy với yêu cầu người dùng. Kích thước và bản phát hành chính xác này giữ danh tính riêng; không nên mặc định những tính năng bổ sung riêng cho kích thước khác hoặc thế hệ Qwen sau áp dụng cho checkpoint này. Hiểu thị giác và quy trình tác tử Qwen mô tả nhận dạng vật thể thông thường và phân tích chữ, biểu đồ, biểu tượng, đồ họa cùng bố cục trang. Với biểu mẫu, chỉ định các trường cần thiết và ý nghĩa của giá trị rỗng. Với biểu đồ, yêu cầu trục, đơn vị và giá trị nhìn thấy làm căn cứ cho kết luận. Yêu cầu tập trung giúp đối chiếu đầu ra với ảnh gốc dễ hơn yêu cầu rộng mô tả mọi thứ. Họ mô hình còn hỗ trợ suy luận tác tử thị giác và chỉ đạo công cụ cho quy trình máy tính hoặc điện thoại. Mô hình có thể diễn giải giao diện và hỗ trợ quyết định hành động; công cụ ứng dụng đã kết nối thực hiện hành động đó. Rà soát ảnh chụp màn hình có thể hỏi điều khiển nào tương ứng nhiệm vụ và thông tin nhìn thấy nào hỗ trợ lựa chọn. Việc dùng suy luận thị giác đó không tự cấp quyền điều khiển thiết bị. Video dài và định vị sự kiện Nhà sản xuất mô tả hiểu video dài hơn một giờ và xác định các đoạn liên quan đến sự kiện được yêu cầu. Đây là khả năng ở cấp họ, không phải giới hạn tải phương tiện lên vô điều kiện hay bảo đảm giữ lại mọi khung hình. Chuẩn bị đoạn liên quan, giữ thông tin thời gian và hỏi chính xác về sự kiện, diễn biến hoặc thay đổi. Cách xử lý video của mô hình dùng thông tin tốc độ khung hình để căn quan sát thị giác với thời gian tuyệt đối. Định vị và tài liệu có cấu trúc Qwen2.5-VL có thể trả vị trí vật thể dưới dạng khung bao hoặc điểm, với tọa độ và thuộc tính trong JSON. Với nhiệm vụ định vị, nêu vật thể mục tiêu và chỉ định kết quả cần là điểm hay khung. Ghi rõ quy ước tọa độ trong ứng dụng sử dụng kết quả thay vì suy ra phép đo vật lý từ ảnh bất kỳ. Nhà sản xuất còn ghi nhận trích xuất có cấu trúc từ hóa đơn quét, biểu mẫu và bảng. Cung cấp trang dễ đọc và lược đồ đầu ra: chẳng hạn tên trường, văn bản trích xuất và vùng nhìn thấy làm căn cứ. Giữ đơn vị, dấu thập phân và tiêu đề bảng trong nguồn. Xem nội dung chưa chắc chắn hoặc không đọc được là trường hợp cần rà soát thay vì yêu cầu mô hình tự tạo giá trị thiếu. Các ví dụ chuẩn bị này áp dụng khả năng được ghi nhận; chúng không bảo đảm trích xuất chính xác tuyệt đối. Thay đổi kiến trúc Độ phân giải ảnh linh hoạt được mở rộng sang video qua huấn luyện tốc độ khung hình biến đổi. Mã hóa vị trí đa phương thức cập nhật biểu diễn chuỗi thời gian và thời gian tuyệt đối, hỗ trợ xác định thời điểm cụ thể và thay đổi tốc độ. Bộ mã hóa thị giác sử dụng window attention cùng SwiGLU và RMSNorm. Các thay đổi mô tả cách mô hình xử lý tư liệu thị giác; chúng không xác lập độ trễ cố định cho ứng dụng cụ thể. Chuẩn bị hình ảnh và video Ví dụ chính thức bao gồm một ảnh, nhiều ảnh, hội thoại chỉ có văn bản, tệp video và danh sách khung hình có thứ tự. Gắn nhãn nhiều đầu vào thị giác để câu hỏi có thể tham chiếu từng phần. Với so sánh ảnh, yêu cầu bảng tổ chức theo nhãn và giới hạn kết quả ở khác biệt nhìn thấy. Với dòng thời gian video, giữ thứ tự khung hình và thông tin thời gian thay vì trình bày ảnh rời rạc như thể chúng có thời lượng đã biết. Phạm vi mặc định được ghi nhận của bộ xử lý ảnh từ bốn đến 16,384 token thị giác mỗi ảnh. Ví dụ có thể hướng tới 256–1,280 token bằng cách đặt giới hạn pixel. Bộ xử lý giữ tỷ lệ khung hình trong giới hạn đó, còn kích thước ảnh sau khi thay đổi theo giá trị chỉ định được căn theo bội số 28. Nhiều chi tiết hơn tiêu tốn thêm tính toán và không gian chuỗi, nên trường chữ nhỏ có thể cần vùng cắt độ phân giải cao hơn, trong khi tóm tắt cảnh rộng có thể không cần. Đây là điều khiển xử lý của nhà sản xuất; tùy chọn tải lên của ứng dụng có thể khác. Ngữ cảnh và giới hạn thực chất Cấu hình checkpoint công bố đặt số vị trí tối đa 128,000, trong khi phần văn bản dài đi kèm vẫn bàn về cấu hình khởi đầu 32,768 token. Hướng dẫn mô tả ngoại suy YaRN nhưng cảnh báo có thể ảnh hưởng đáng kể tới định vị thời gian và không gian, và không khuyến nghị phương pháp đó cho các nhiệm vụ này. Tài liệu lưu ý riêng rằng mã hóa vị trí video có thể cho phép thiết lập vị trí lớn hơn, lấy 64K làm ví dụ. Không nên gộp các mô tả cấu hình khác nhau này thành một mức trần đầu vào được xác nhận phổ quát. Văn bản, tư liệu thị giác và câu trả lời dùng chung ngân sách chuỗi hữu hạn. Giữ nội dung liên quan dễ đọc, dành chỗ cho kết quả và đối chiếu văn bản trích xuất, tọa độ, thời điểm sự kiện với bản gốc. Ví dụ tạo sinh 128 token của thẻ mang tính minh họa và không xác lập mức tối đa đầu ra cứng riêng. Mô hình này trả phân tích văn bản hoặc thông tin có cấu trúc; khả năng thị giác-ngôn ngữ không có nghĩa nó tạo hình ảnh hoặc video. Tác vụ thực tế ### Tác vụ thực tế Ví dụ kỹ thuật bằng tiếng Anh ``` Organize a recorded event timeline Use only these text annotations from a clip: 00:02 worker picks up a box; 00:05 worker places the box on the scale; 00:08 scale display is obscured; 00:11 worker removes the box. Return the event sequence, the first annotated placement time and whether the weight is established. Preserve timestamps without claiming frame-level inspection. ``` #### Kết quả mong đợi ``` An ordered event table, a placement-time field and an unresolved weight field. ``` #### Kiểm tra kết quả ``` Check that obscured weight remains unknown and the placement timestamp is attributed to the supplied annotation. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `qwen2.5-vl-3b-instruct` [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=chat) Alibaba /`qwen2.5-vl-3b-instruct` ### Bắt đầu Qwen2.5-VL-3B-Instruct là mô hình thị giác-ngôn ngữ nhỏ gọn được tinh chỉnh theo chỉ dẫn của Qwen cho văn bản, hình ảnh và video. Mô hình trả về văn bản và thông tin thị giác có cấu trúc, gồm trường tài liệu, tọa độ vật thể và mô tả sự kiện, với độ phân giải động và xử lý video có xét thời gian. Đầ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 qwen2.5-vl-3b-instruct | 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 Ví dụ: system, user, assistant, tool, function Điều kiện: Các vai trò này được biểu diễn rõ trong các kiểu tương thích của mã nguồn; tập vai trò chính xác vẫn tùy từng mô hình. Tùy thuộc vào mô hình | Mặc định— | | Trường`messages[].content` | Loại`string\|content_part[]\|null` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`messages[].tool_calls` | Loại`tool_call[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`messages[].tool_call_id` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Áp dụng khi: role=tool; dùng ID thực tế được trả về | Mặc định— | | Trường`messages[].name` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`messages[].reasoning_content` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Áp dụng khi: Gửi lại dữ liệu suy luận thực tế đã được trả về khi mô hình này sử dụng dữ liệu đó | Mặc định— | | Trường`messages[].reasoning_details` | Loại`object\|array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`max_tokens` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tùy thuộc vào mô hình | Mặc định— | | Trường`max_completion_tokens` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tùy thuộc vào mô hình | 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 | | Trường`stream_options.include_usage` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`temperature` | Loại`number` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`top_p` | Loại`number` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`stop` | Loại`string\|string[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`tools` | Loại`function_tool[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`tools[].type` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn function Tùy thuộc vào mô hình | Mặc định— | | Trường`tools[].function.name` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Áp dụng khi: Có cung cấp công cụ hàm | Mặc định— | | Trường`tools[].function.description` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`tools[].function.parameters` | Loại`JSON_schema` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`tool_choice` | Loại`string\|object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`parallel_tool_calls` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`response_format` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`reasoning_effort` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`reasoning` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`service_tier` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`instructions` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Trường tương thích | Mặc định— | | Trường`functions` | Loại`function[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`function_call` | Loại`string\|object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`prompt_cache_options` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`modalities` | Loại`string[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn text | Mặc định— | | Trường`provider` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: provider.options bị từ chối trên tuyến văn bản Ultra này | Mặc định— | | Trường`cache_control.ttl` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: 1h bị từ chối tại các vị trí lưu đệm prompt thực tế | Mặc định— | 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, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Tham số`control_scope` | Hợp đồngTùy từng mô hình; công cụ hàm của người dùng khác với công cụ do dịch vụ cung cấp | | Tham số`output_modalities` | Hợp đồngtext | | Tham số`hosted_operations` | Hợp đồngfalse | | Tham số`multimodal_input_binding` | Hợp đồngnull | 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 #### 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.0004** / 1K token Đầu ra · Token đầu ra **$0.0012** / 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 SDKLuồng Python ```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": "qwen2.5-vl-3b-instruct", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') 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='qwen2.5-vl-3b-instruct',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) 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")) ``` ```python from openai import OpenAI import os from pathlib import Path 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) 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)) with client.chat.completions.stream(model='qwen2.5-vl-3b-instruct',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### 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** [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=chat) #### Bí danh đường dẫn phương thức Dùng các đường dẫn phương thức hiển thị ở trên. #### ID gọi liên quan [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=chat) **Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `qwen2.5-vl-3b-instruct` [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=messages) Alibaba /`qwen2.5-vl-3b-instruct` ### Bắt đầu Qwen2.5-VL-3B-Instruct là mô hình thị giác-ngôn ngữ nhỏ gọn được tinh chỉnh theo chỉ dẫn của Qwen cho văn bản, hình ảnh và video. Mô hình trả về văn bản và thông tin thị giác có cấu trúc, gồm trường tài liệu, tọa độ vật thể và mô tả sự kiện, với độ phân giải động và xử lý video có xét thời gian. Đầ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 qwen2.5-vl-3b-instruct | 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 #### 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.0004** / 1K token Đầu ra · Token đầu ra **$0.0012** / 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": "qwen2.5-vl-3b-instruct", "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': 'qwen2.5-vl-3b-instruct', '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': 'qwen2.5-vl-3b-instruct', '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** [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=messages) #### Bí danh đường dẫn phương thức Dùng các đường dẫn phương thức hiển thị ở trên. #### ID gọi liên quan [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=messages) FAQ · Qwen2.5-VL-3b Có những đầu vào và kết quả nào? `POST /v1/chat/completions` · `qwen2.5-vl-3b-instruct`: `text` → `text` `POST /v1/messages` · `qwen2.5-vl-3b-instruct`: `text` → `json`, `sse` Yêu cầu sử dụng những trường nào? `POST /v1/chat/completions` · `qwen2.5-vl-3b-instruct`: `model`, `messages`, `stream`, `modalities`, `provider` `POST /v1/messages` · `qwen2.5-vl-3b-instruct`: `model`, `messages`, `max_tokens`, `stream` Áp dụng những giới hạn nào? `POST /v1/chat/completions` · `qwen2.5-vl-3b-instruct`: `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.