Source: https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/ Canonical: https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/ Language: vi # Qwen2-VL-7B-Instruct-ultra [Markdown](https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/index.md) · [JSON](https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/facts.json) ## [Qwen2-VL-7B-Instruct-ultra](https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/) Qwen2-VL-7B-Instruct là mô hình thị giác-ngôn ngữ được tinh chỉnh theo chỉ dẫn của Qwen, nhận văn bản, hình ảnh và video, rồi trả về văn bản. Dùng mô hình để hỏi về trang tài liệu, so sánh ảnh hoặc mô tả sự kiện nhìn thấy, với độ phân giải ảnh động và các hạn chế đã được tài liệu hóa về đếm, suy luận không gian và hiểu âm thanh trong video. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `Qwen2-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/#method-0) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `Qwen2-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/qwen2-vl-7b-instruct-ultra/#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 thị giác-ngôn ngữ 7B Qwen2-VL-7B-Instruct là thành viên 7B của Qwen2-VL được tinh chỉnh theo chỉ dẫn. Mô hình kết hợp chỉ dẫn văn bản với hình ảnh hoặc video và tạo câu trả lời bằng văn bản. Đầu ra hữu ích gồm giải thích trang tài liệu, so sánh ảnh, mô tả sự kiện nhìn thấy hoặc trả lời câu hỏi về biểu đồ. Đây vẫn là đúng bản phát hành Qwen2-VL này; các checkpoint Qwen2.5-VL và Qwen3-VL mới hơn có khả năng và định danh riêng. Những bổ sung của Qwen2-VL Qwen mô tả khả năng hiểu hình ảnh ở nhiều độ phân giải và tỷ lệ khung hình, cùng khả năng trả lời câu hỏi về video, hội thoại và sáng tạo nội dung. Khả năng video được tài liệu hóa của họ mô hình bao gồm tư liệu dài hơn 20 phút. Chỉ riêng thời lượng không xác lập số khung hình mà ứng dụng xử lý hay bảo đảm nhớ mọi sự kiện. Khả năng hiểu văn bản trong hình ảnh đa ngôn ngữ bao gồm tiếng Anh và tiếng Trung, nhiều ngôn ngữ châu Âu, tiếng Nhật, tiếng Hàn, tiếng Ả Rập và tiếng Việt. Nhà phát triển cũng mô tả tích hợp với điện thoại, robot và thiết bị khác thông qua quan sát hình ảnh và chỉ dẫn văn bản. Đây là quy trình ứng dụng: mô hình diễn giải môi trường nhìn thấy và hỗ trợ chọn hành động, còn phần mềm hoặc phần cứng kết nối thực hiện chúng. Nhận diện màn hình không tự mang lại quyền điều khiển màn hình. Thay đổi kiến trúc Độ phân giải động chuyển ảnh thành số lượng token thị giác thay đổi thay vì buộc mọi đầu vào vào cùng một biểu diễn. M-ROPE tách thông tin vị trí cho văn bản, hình ảnh hai chiều và thông tin video ba chiều, kết hợp cấu trúc không gian với thời gian. Cấu hình 7B công bố 32,768 vị trí. Văn bản, token thị giác và đầu ra được tạo dùng chung ngân sách chuỗi hữu hạn, nên độ phân giải ảnh và cách lấy mẫu video ảnh hưởng đến lượng tư liệu mà một yêu cầu có thể chứa. Chuẩn bị hình ảnh và hội thoại Các ví dụ chính thức hỗ trợ một ảnh, nhiều ảnh và hội thoại chỉ có văn bản. Đính kèm ảnh với một câu hỏi cụ thể thay vì dựa vào chỉ dẫn rộng như “phân tích mọi thứ.” Với trang tài liệu, yêu cầu các trường xác định và giữ dấu câu trong trích dẫn. Với hai ảnh chụp màn hình thiết kế, gắn nhãn thứ nhất và thứ hai, sau đó yêu cầu bảng các thay đổi nhìn thấy. Với biểu đồ, hỏi nhãn, đơn vị và các giá trị làm căn cứ cho xu hướng đã nêu. Đây là ứng dụng thực tế của trả lời câu hỏi thị giác, không phải cam kết trích xuất không có lỗi. Các tiện ích của nhà phát triển nhận ảnh từ tệp cục bộ, dữ liệu ảnh mã hóa hoặc vị trí ảnh; ví dụ video được tài liệu hóa dùng tệp video cục bộ hoặc danh sách khung hình có thứ tự. Định dạng tải lên của ứng dụng vẫn là quyết định giao diện riêng. Giữ nguyên thứ tự khung hình gốc và nêu khoảng thời gian mà danh sách khung hình biểu diễn. Các ví dụ tạo văn bản; checkpoint này không được mô tả là bộ tạo ảnh hoặc video. Độ phân giải và chuẩn bị video Bộ xử lý của Qwen dùng khoảng mặc định từ bốn đến 16,384 token thị giác cho mỗi ảnh. Bộ xử lý cung cấp min\_pixels và max\_pixels để cân bằng chi tiết với bộ nhớ và tính toán, với ví dụ được tài liệu hóa nhắm đến 256–1,280 token thị giác. Ảnh được đổi kích thước trong các giới hạn đã chọn và giữ tỷ lệ khung hình. Kích thước thay đổi được chỉ định tường minh được làm tròn về bội số của 28. Bảng dày đặc hoặc chữ nhỏ có thể cần độ phân giải đủ lớn để đọc được; tăng độ phân giải cũng tiêu tốn thêm ngân sách thị giác và ngữ cảnh hiện có. Ví dụ video dùng tốc độ lấy mẫu một khung hình mỗi giây và giới hạn pixel có thể cấu hình. Đây là các thiết lập ví dụ, không phải tốc độ bắt buộc chung hay giới hạn đa phương tiện cứng. Khi kiểm tra sự kiện, cung cấp đoạn liên quan và yêu cầu mô tả có thứ tự các thay đổi nhìn thấy. Các sự kiện xảy ra sát nhau có thể cần lấy mẫu dày hơn bản tóm tắt cảnh tổng quát. Qwen2-VL không hiểu thông tin âm thanh trong video, nên hội thoại hoặc hiệu ứng âm thanh cần quy trình âm thanh riêng. Hạn chế đã biết Qwen ghi nhận mốc kết thúc dữ liệu huấn luyện hình ảnh là tháng 6 năm 2023, không bảo đảm kiến thức về người, sản phẩm hoặc sự kiện sau đó. Khả năng nhận diện các cá nhân cụ thể và tài sản trí tuệ chưa đầy đủ. Chỉ dẫn phức tạp nhiều bước, đếm đối tượng trong cảnh đông và quan hệ không gian—đặc biệt trong ba chiều—là các điểm yếu đã được tài liệu hóa. Chia tác vụ thị giác phức tạp thành câu hỏi rõ ràng, yêu cầu bằng chứng nhìn thấy làm căn cứ cho kết quả và đối chiếu số trích xuất cùng văn bản được trích dẫn với ảnh. Chú thích nghe hợp lý không nên được coi là số đếm chính xác hoặc vị trí ba chiều đã đo. Các ví dụ sinh ngắn trong thẻ không xác lập giới hạn cứng riêng cho đầu ra. Lên kế hoạch độ dài câu trả lời cùng đầu vào văn bản và thị giác, đồng thời giữ đủ chi tiết trong nguồn cho câu hỏi cụ thể. Điều này giúp việc chọn mô hình và chuẩn bị đầu vào hữu ích hơn giả định rằng mọi ảnh hoặc mọi video dài đều cho câu trả lời đáng tin cậy như nhau. Tác vụ thực tế ### Tác vụ thực tế Ví dụ kỹ thuật bằng tiếng Anh ``` Compare transcribed dashboard changes Compare these dashboard descriptions supplied as text. First: heading 'Orders', filter 'All dates', total 240. Second: heading 'Orders', filter 'This week', total 38. Return a table of changed and unchanged fields, then explain why the totals alone do not establish a fall in orders. Use only the descriptions and keep the filter labels exact. ``` #### Kết quả mong đợi ``` A field-comparison table and a short explanation of the different date scopes. ``` #### Kiểm tra kết quả ``` The result does not treat totals from All dates and This week as comparable periods. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `Qwen2-VL-7B-Instruct-ultra` [`Qwen2-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/#m=Qwen2-VL-7B-Instruct-ultra&route=Ultra&caller=Qwen2-VL-7B-Instruct-ultra&fmt=chat) Khác /`Qwen2-VL-7B-Instruct-ultra` ### Bắt đầu Qwen2-VL-7B-Instruct là mô hình thị giác-ngôn ngữ được tinh chỉnh theo chỉ dẫn của Qwen, nhận văn bản, hình ảnh và video, rồi trả về văn bản. Dùng mô hình để hỏi về trang tài liệu, so sánh ảnh hoặc mô tả sự kiện nhìn thấy, với độ phân giải ảnh động và các hạn chế đã được tài liệu hóa về đếm, suy luận không gian và hiểu âm thanh trong video. Đầ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-VL-7B-Instruct-ultra | 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.00058** / 1K token Đầu ra · Token đầu ra **$0.00142** / 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-VL-7B-Instruct-ultra", "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-VL-7B-Instruct-ultra',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-VL-7B-Instruct-ultra',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-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/#m=Qwen2-VL-7B-Instruct-ultra&route=Ultra&caller=Qwen2-VL-7B-Instruct-ultra&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-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/#m=Qwen2-VL-7B-Instruct-ultra&route=Ultra&caller=Qwen2-VL-7B-Instruct-ultra&fmt=chat) **Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `Qwen2-VL-7B-Instruct-ultra` [`Qwen2-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/#m=Qwen2-VL-7B-Instruct-ultra&route=Ultra&caller=Qwen2-VL-7B-Instruct-ultra&fmt=messages) Khác /`Qwen2-VL-7B-Instruct-ultra` ### Bắt đầu Qwen2-VL-7B-Instruct là mô hình thị giác-ngôn ngữ được tinh chỉnh theo chỉ dẫn của Qwen, nhận văn bản, hình ảnh và video, rồi trả về văn bản. Dùng mô hình để hỏi về trang tài liệu, so sánh ảnh hoặc mô tả sự kiện nhìn thấy, với độ phân giải ảnh động và các hạn chế đã được tài liệu hóa về đếm, suy luận không gian và hiểu âm thanh trong video. Đầ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-VL-7B-Instruct-ultra | 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.00058** / 1K token Đầu ra · Token đầu ra **$0.00142** / 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-VL-7B-Instruct-ultra", "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-VL-7B-Instruct-ultra', '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-VL-7B-Instruct-ultra', '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-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/#m=Qwen2-VL-7B-Instruct-ultra&route=Ultra&caller=Qwen2-VL-7B-Instruct-ultra&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-VL-7B-Instruct-ultra`](https://ailoot.ai/models/vi/#m=Qwen2-VL-7B-Instruct-ultra&route=Ultra&caller=Qwen2-VL-7B-Instruct-ultra&fmt=messages) FAQ · Qwen2-VL-7B-Instruct-ultra Có những đầu vào và kết quả nào? `POST /v1/chat/completions` · `Qwen2-VL-7B-Instruct-ultra`: `text` → `text` `POST /v1/messages` · `Qwen2-VL-7B-Instruct-ultra`: `text` → `json`, `sse` Yêu cầu sử dụng những trường nào? `POST /v1/chat/completions` · `Qwen2-VL-7B-Instruct-ultra`: `model`, `messages`, `stream`, `modalities`, `provider` `POST /v1/messages` · `Qwen2-VL-7B-Instruct-ultra`: `model`, `messages`, `max_tokens`, `stream` Áp dụng những giới hạn nào? `POST /v1/chat/completions` · `Qwen2-VL-7B-Instruct-ultra`: `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.