Source: https://ailoot.ai/models/vi/qwen2-5-vl-7b-instruct/ Canonical: https://ailoot.ai/models/vi/qwen2-5-vl-7b-instruct/ Language: vi # Qwen2.5 VL 7B Instruct [Markdown](https://ailoot.ai/models/vi/qwen2-5-vl-7b-instruct/index.md) · [JSON](https://ailoot.ai/models/vi/qwen2-5-vl-7b-instruct/facts.json) ## [Qwen2.5 VL 7B Instruct](https://ailoot.ai/models/vi/qwen2-5-vl-7b-instruct/) Qwen2.5-VL-7B-Instruct là mô hình thị giác-ngôn ngữ cho hình ảnh, tài liệu và video. Mô hình tạo văn bản và kết quả có cấu trúc, bao gồm khung bao vật thể, điểm và thuộc tính, đồng thời mang khả năng định vị sự kiện theo thời gian và tác tử thị giác tới phiên bản 7B. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `qwen2.5-vl-7b-instruct`](https://ailoot.ai/models/vi/qwen2-5-vl-7b-instruct/#method-0) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `qwen2.5-vl-7b-instruct`](https://ailoot.ai/models/vi/qwen2-5-vl-7b-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. Qwen2.5-VL-7B-Instruct là phiên bản 7B được tinh chỉnh theo chỉ dẫn của Qwen2.5-VL. Mô hình kết nối chỉ dẫn văn bản với hình ảnh hoặc video và trả về kết quả văn bản. Các cải tiến chính của nhà sản xuất bao gồm nhận dạng vật thể và chi tiết thị giác, phân tích chữ và bố cục, nhiệm vụ tác tử thị giác, hiểu sự kiện trong video dài, định vị vật thể và trích xuất tài liệu có cấu trúc. Hiểu nội dung thị giác Họ mô hình vượt ra ngoài việc nhận ra chủ thể chính của ảnh. Nhiệm vụ được ghi nhận gồm phân tích chữ, biểu đồ, biểu tượng, đồ họa và cách sắp xếp các thành phần trong ảnh. Với biểu đồ, chỉ định chuỗi dữ liệu hoặc quan hệ cần xem xét và giữ trục, chú giải, đơn vị. Với sơ đồ, hỏi cách các thành phần gắn nhãn liên kết và bố trí nhìn thấy cho biết điều gì về quy trình. Phép so sánh hữu ích có thể cung cấp thiết kế gốc và thiết kế sửa đổi, xác định từng bản và hỏi các thay đổi nhìn thấy theo danh sách yêu cầu ngắn. Yêu cầu quan sát đi cùng vùng ảnh liên quan. Điều này tạo mục đích cụ thể cho câu trả lời thay vì yêu cầu mô tả chung hai ảnh không liên quan. Quy trình tác tử thị giác Nhà sản xuất định vị Qwen2.5-VL là tác tử thị giác có thể suy luận về màn hình và chỉ đạo công cụ trong nhiệm vụ sử dụng máy tính hoặc điện thoại. Mô hình cung cấp diễn giải và thao tác đề xuất; ứng dụng tác tử bao quanh cung cấp điều khiển, thực thi thao tác và trả trạng thái mới. Vì vậy câu trả lời văn bản hoặc tọa độ dự đoán là một phần của quy trình tích hợp đó. Với câu hỏi giao diện, cung cấp ảnh chụp màn hình và mục tiêu thực tế, rồi hỏi điều khiển nhìn thấy nào liên quan và nên làm gì tiếp theo. Giữ đầu ra yêu cầu cụ thể: nhãn điều khiển, vị trí và hành động dự kiến. Nếu ứng dụng thực hiện hành động đó, ảnh chụp tiếp theo cung cấp đầu vào thị giác cập nhật cho quyết định sau. Video dài và định vị sự kiện Nhà sản xuất mô tả khả năng hiểu video dài hơn một giờ và xác định đoạn chứa sự kiện được yêu cầu. Điều này mở rộng mô tả video sang định vị theo thời gian. Nhiệm vụ có thể hỏi khi nào vật thể xuất hiện lần đầu, ở đâu phần minh họa đạt bước cụ thể hoặc sự kiện nhìn thấy nào diễn ra trước sự kiện khác. Nêu kết quả cần là tóm tắt, danh sách sự kiện có thứ tự hay thời điểm bắt đầu và kết thúc kèm mô tả sự kiện. Họ mô hình được huấn luyện với lấy mẫu tốc độ khung hình động và căn chỉnh thông tin vị trí theo thời gian với thời gian tuyệt đối. Vì vậy thông tin tốc độ khung hình thuộc việc chuẩn bị video, không phải nhãn tùy ý có thể bỏ đi khi dấu thời gian quan trọng. Khả năng video dài được ghi nhận không phải thông số dung lượng tệp hoặc thời lượng tối đa phổ quát cho mọi đường đầu vào. Định vị vật thể và tài liệu có cấu trúc Qwen2.5-VL có thể trả về khung bao hoặc điểm và tổ chức tọa độ, thuộc tính dưới dạng JSON. Bản phát hành sử dụng tọa độ theo kích thước ảnh thực tế thay vì tọa độ chuẩn hóa truyền thống. Chỉ định nhiệm vụ cần khung bao, điểm cụ thể hay mô tả vật thể, đồng thời giữ kích thước ảnh và thông tin đổi kích thước cần thiết để diễn giải vị trí trả về. Chẳng hạn yêu cầu kiểm kê bằng hình ảnh có thể hỏi từng vật thể mục tiêu, khung bao và thuộc tính nhìn thấy. Nhiệm vụ theo điểm có thể hỏi vị trí của điều khiển có nhãn hoặc bộ phận được chỉ định của vật thể. Đây là thiết kế đầu ra đề xuất, không phải tên trường cố định mà mọi yêu cầu phải dùng. Giữ từng tọa độ gắn với ảnh nguồn khi cung cấp nhiều ảnh. Nhà sản xuất nhấn mạnh riêng trích xuất có cấu trúc từ hóa đơn quét, biểu mẫu và bảng. Xác định các trường, giữ nhãn gốc và yêu cầu cách biểu diễn rõ ràng khi không đọc được giá trị. Với bảng, giữ tiêu đề cột và đơn vị cùng các hàng yêu cầu. Bản ghi thực tế có thể gồm mã tài liệu, nhãn trường, giá trị trích xuất và vị trí, giúp đầu ra dùng được cho so sánh sau này hoặc kiểm tra thủ công. Kiến trúc và chuẩn bị đầu vào Mô hình kết hợp độ phân giải ảnh linh hoạt và lấy mẫu video linh hoạt với thông tin vị trí xoay đa phương thức được cập nhật. Bộ mã hóa thị giác dùng window attention, SwiGLU và RMSNorm. Đây là thay đổi kiến trúc hỗ trợ xử lý thị giác và thời gian; chúng không thêm đầu vào âm thanh hay tạo ảnh vào quy trình kết quả văn bản được ghi nhận. Thẻ minh họa một ảnh, nhiều ảnh, chuỗi khung hình video, tệp hoặc tham chiếu video và các hội thoại theo lô. Bộ xử lý ảnh ghi nhận phạm vi mặc định từ 4 đến 16,384 token thị giác mỗi ảnh. Thiết lập pixel tối thiểu và tối đa giữ tỷ lệ khung hình; kích thước chính xác được yêu cầu làm tròn tới bội số 28. Phạm vi ví dụ từ 256 đến 1,280 token thị giác là minh họa có thể điều chỉnh, không phải giới hạn ảnh cứng riêng. Giữ chi tiết cần cho câu hỏi khi chọn đổi kích thước. Ngữ cảnh và thiết lập nhạy với định vị Cấu hình phát hành đặt số vị trí tối đa là 128,000. Phần văn bản dài của thẻ mô hình mô tả riêng mức cơ sở 32,768 token và ví dụ mở rộng YaRN. Tài liệu cảnh báo rõ mở rộng này ảnh hưởng đáng kể tới định vị thời gian và không gian, và không khuyến nghị sử dụng. Hướng dẫn còn bàn về thay đổi số vị trí tối đa cho video dài; đây là ghi chú cấu hình thay vì một giới hạn đầu vào vô điều kiện cho mọi nhiệm vụ. Giữ cấu hình bản phát hành chính xác và tiền xử lý thị giác phù hợp nhiệm vụ, nhất là khi tọa độ hoặc thời điểm sự kiện quan trọng. Ví dụ tạo sinh 128 token của thẻ không chỉ định năng lực đầu ra tối đa riêng. Qwen2.5-VL-7B-Instruct tạo văn bản, tọa độ và kết quả có cấu trúc; hành động bên ngoài, ảnh kết xuất, video hay câu trả lời bằng giọng nói cần thành phần ứng dụng khác. Tác vụ thực tế ### Tác vụ thực tế Ví dụ kỹ thuật bằng tiếng Anh ``` Extract a transcribed invoice table Extract line items from this invoice transcription: "Invoice N-33; item | quantity | unit price; Clip | 4 | 2.50; Folder | 2 | unreadable." Return each item with quantity, unit price and source invoice ID. Mark the unreadable price explicitly and do not infer it from a total. No image is supplied. ``` #### Kết quả mong đợi ``` A two-row field table retaining N-33 and an explicit unreadable value for the folder unit price. ``` #### Kiểm tra kết quả ``` Verify quantities are not swapped and the unreadable price is neither zero nor a guessed amount. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `qwen2.5-vl-7b-instruct` [`qwen2.5-vl-7b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-7b-instruct&route=Ultra&caller=qwen2.5-vl-7b-instruct&fmt=chat) Alibaba /`qwen2.5-vl-7b-instruct` ### Bắt đầu Qwen2.5-VL-7B-Instruct là mô hình thị giác-ngôn ngữ cho hình ảnh, tài liệu và video. Mô hình tạo văn bản và kết quả có cấu trúc, bao gồm khung bao vật thể, điểm và thuộc tính, đồng thời mang khả năng định vị sự kiện theo thời gian và tác tử thị giác tới phiên bản 7B. Đầ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-7b-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.0001** / 1K token Đầu ra · Token đầu ra **$0.0001** / 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-7b-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-7b-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-7b-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-7b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-7b-instruct&route=Ultra&caller=qwen2.5-vl-7b-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-7b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-7b-instruct&route=Ultra&caller=qwen2.5-vl-7b-instruct&fmt=chat) **Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `qwen2.5-vl-7b-instruct` [`qwen2.5-vl-7b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-7b-instruct&route=Ultra&caller=qwen2.5-vl-7b-instruct&fmt=messages) Alibaba /`qwen2.5-vl-7b-instruct` ### Bắt đầu Qwen2.5-VL-7B-Instruct là mô hình thị giác-ngôn ngữ cho hình ảnh, tài liệu và video. Mô hình tạo văn bản và kết quả có cấu trúc, bao gồm khung bao vật thể, điểm và thuộc tính, đồng thời mang khả năng định vị sự kiện theo thời gian và tác tử thị giác tới phiên bản 7B. Đầ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-7b-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.0001** / 1K token Đầu ra · Token đầu ra **$0.0001** / 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-7b-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-7b-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-7b-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-7b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-7b-instruct&route=Ultra&caller=qwen2.5-vl-7b-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-7b-instruct`](https://ailoot.ai/models/vi/#m=qwen2.5-vl-7b-instruct&route=Ultra&caller=qwen2.5-vl-7b-instruct&fmt=messages) FAQ · Pro/Qwen/Qwen2.5-VL-7B-Instruct Có những đầu vào và kết quả nào? `POST /v1/chat/completions` · `qwen2.5-vl-7b-instruct`: `text` → `text` `POST /v1/messages` · `qwen2.5-vl-7b-instruct`: `text` → `json`, `sse` Yêu cầu sử dụng những trường nào? `POST /v1/chat/completions` · `qwen2.5-vl-7b-instruct`: `model`, `messages`, `stream`, `modalities`, `provider` `POST /v1/messages` · `qwen2.5-vl-7b-instruct`: `model`, `messages`, `max_tokens`, `stream` Áp dụng những giới hạn nào? `POST /v1/chat/completions` · `qwen2.5-vl-7b-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.