> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-ko/deploy/supported-models/qwen3-vl.md).

# Qwen3-VL

Qwen3-VL은 Alibaba의 vision-language model입니다. 이미지를 받아들이고 텍스트 프롬프트를 입력받아 텍스트 응답을 반환합니다. 우리는 다음을 통해 Qwen3-VL을 지원합니다. [Serverless Hosted API](/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2.md), [Dedicated Deployments](/roboflow/roboflow-ko/deploy/dedicated-deployments.md), 그리고 [self-hosted Inference](https://inference.roboflow.com/).

## 코드 샘플

다음을 설치하세요: [Inference SDK](https://inference.roboflow.com/):

```bash
pip install inference-sdk
```

다음을 전달하세요 [Roboflow API Key](https://app.roboflow.com/settings/api) 다음을 통해 `API_KEY` 환경 변수.

```python
import os
import urllib.request
from inference_sdk import InferenceHTTPClient

image_url = "https://media.roboflow.com/notebooks/examples/dog.jpeg"
image_path = "dog.jpeg"
urllib.request.urlretrieve(image_url, image_path)

client = InferenceHTTPClient(
    api_url="https://serverless.roboflow.com",
    api_key=os.getenv("API_KEY"),
)
result = client.infer_lmm(
    image_path,
    model_id="qwen3vl-2b-instruct",
    prompt="이 이미지를 간단히 설명하세요.",
    max_new_tokens=128,
)
print(result["response"])
```

위 코드는 모델 응답을 터미널에 출력합니다:

```
파란 얼굴과 몸을 가진 사람이 파란 개를 어깨에 메고 있습니다. 개는 혀를 내밀고 헐떡이고 있습니다. 사람은 검은색 백팩과 검은색 모자를 쓰고 있습니다. 배경에는 건물과 파란 차가 있는 도시의 거리가 보입니다.
```

{% hint style="info" %}
설정하세요 `api_url` 를 배포 대상에 맞게:

* `https://serverless.roboflow.com` 은 Serverless Hosted API용입니다.
* `http://localhost:9001` 로컬 [Inference](https://inference.roboflow.com/) 서버용입니다.
* 귀하의 [Dedicated Deployment](/roboflow/roboflow-ko/deploy/dedicated-deployments.md) 비공개 엔드포인트용 URL입니다.
  {% endhint %}

Roboflow에서 자신만의 Qwen3-VL 체크포인트를 학습하고, 이를 `workspace/project/version` 식별자로 호출할 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/deploy/supported-models/qwen3-vl.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.