Qwen 3.7 Plus API 사용법

Qwen 3.7 Plus는 Alibaba의 멀티모달 에이전트 모델입니다. 텍스트, 이미지, 비디오를 입력으로 받고 1백만 토큰의 컨텍스트를 지원하며 합리적인 가격을 자랑합니다. API 형태로만 제공되기 때문에 실제적인 질문들이 즉시 떠오릅니다. 키는 어떻게 얻고, 이미지는 어떻게 전송하며, 비용은 얼마나 들까요? 이 가이드는 이 세 가지 질문에 모두 답해줍니다.

액세스 방법, 키 얻는 법, Python, curl, JavaScript를 사용한 첫 번째 요청, 멀티모달 페이로드 형식, 비용 예시를 포함한 전체 가격 분석, 그리고 속도 제한에 대해 다룰 것입니다. 이 과정에서 Apidog를 사용하여 테스트 요청을 보내고, 원시 응답을 검사하며, 엔드포인트를 모의(mock)하여 앱 개발을 계속할 수 있도록 할 것입니다. 먼저 기능과 벤치마크를 원하시면, 저희의 Qwen 3.7 Plus 개요를 참조하세요. 텍스트 전용 플래그십 모델에 대해서는 기본 Qwen 3.7 API 가이드를 참조하세요.

button

요약 (TL;DR)

Qwen 3.7 Plus는 Alibaba Cloud Model Studio를 통해 OpenAI 호환 엔드포인트에서 실행됩니다. 지역 기반 URL을 설정하고, Bearer 토큰으로 키를 전달하며, qwen3.7-plus 모델 ID로 /chat/completions를 호출합니다. 멀티모달 요청은 메시지 콘텐츠에 이미지 또는 비디오 부분을 추가합니다. 가격은 입력 토큰 100만 개당 $0.40, 출력 토큰 100만 개당 $1.60이며, 캐시된 입력은 $0.08로 Qwen3.7-Max보다 약 6배 저렴합니다. 영구적인 무료 계층은 없지만, 신규 계정에는 한 번의 무료 할당량이 제공됩니다. 비전 토큰은 컨텍스트 예산을 공유하므로, 이미지와 비디오가 비용을 증가시키는 요인이 됩니다. 배포 전에 Model Studio 문서에서 정확한 모델 ID를 확인하세요.

Qwen 3.7 Plus에 액세스하는 방법

초기에 채팅 전용 미리 보기로 제공되었던 텍스트 플래그십 모델과 달리, Plus는 첫날부터 상업용 API입니다. 두 가지 중요한 표면이 있습니다.

Qwen Chat (chat.qwen.ai). 이미지를 사용하여 Plus를 가장 빠르게 시도할 수 있는 방법입니다. 로그인하고 Plus 모델을 선택한 다음, 스크린샷을 드롭하여 어떻게 작동하는지 확인합니다. 이는 평가용이며 통합용이 아닙니다.

Alibaba Cloud Model Studio (DashScope). 이것이 실제 API입니다. Model Studio는 OpenAI 호환 엔드포인트를 통해 Plus를 노출하므로, OpenAI SDK와 이미 통신하는 모든 코드는 기본 URL과 키를 교체하여 호출할 수 있습니다.

한 가지 계획해야 할 어려운 제한 사항: Plus는 독점적입니다. 다운로드할 수 있는 오픈 가중치가 없으므로, 자체 호스팅하거나 에어갭 환경에서 실행할 수 없습니다. 이것이 요구 사항이라면, 저희의 Qwen 3.7 Plus 개요에서 자세히 다룹니다.

방법	API 액세스	비용	가장 적합한 용도
Qwen Chat (chat.qwen.ai)	불가	무료, 속도 제한 있음	이미지를 사용한 빠른 평가
Model Studio (DashScope)	가능, OpenAI 호환	토큰당 지불	운영 통합
자체 호스팅	불가	해당 없음	사용 불가; 가중치가 비공개임

Qwen 3.7 Plus API 키 얻기

액세스는 Alibaba Cloud 계정을 통해 이루어집니다.

Alibaba Cloud 계정을 생성하고 Model Studio 콘솔(modelstudio.console.alibabacloud.com)을 엽니다.
계정과 지역에 대해 Model Studio를 활성화합니다. 키는 지역 범위이므로 싱가포르 키는 베이징에 대해 인증되지 않습니다.
API 키 섹션을 열고 키를 생성합니다. sk-로 시작하는 문자열처럼 보입니다.
한 번 복사한 후 비밀번호처럼 안전하게 보관하세요.

사용하는 지역에 따라 기본 URL이 설정됩니다:

지역	기본 URL
싱가포르	`https://dashscope-intl.aliyuncs.com/compatible-mode/v1`
미국 (버지니아)	`https://dashscope-us.aliyuncs.com/compatible-mode/v1`
베이징 (중국)	`https://dashscope.aliyuncs.com/compatible-mode/v1`

키는 소스 제어에서 제외하세요. 환경 변수를 사용하세요:

# macOS / Linux
export DASHSCOPE_API_KEY="sk-your-key-here"

# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-your-key-here"

첫 번째 요청: Python, curl, JavaScript

엔드포인트는 OpenAI 호환이므로, DashScope 기본 URL을 가리키는 공식 OpenAI SDK를 사용하거나 원시 HTTP 호출을 사용할 수 있습니다. 모델 ID는 qwen3.7-plus이지만, 식별자는 변경될 수 있으므로 배포 전에 Model Studio 모델 목록에서 현재 문자열을 확인하세요.

OpenAI SDK를 사용한 Python

pip install openai로 설치한 다음:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[{"role": "user", "content": "Qwen 3.7 Plus 가격 모델을 두 문장으로 요약해 주세요."}],
)
print(resp.choices[0].message.content)

curl

curl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "Qwen 3.7 Plus API에서 보냅니다."}]
  }'

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DASHSCOPE_API_KEY,
  baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
});

const resp = await client.chat.completions.create({
  model: "qwen3.7-plus",
  messages: [{ role: "user", content: "Qwen 3.7 Plus API에서 보냅니다." }],
});
console.log(resp.choices[0].message.content);

이미지 및 비디오 전송

Max 대신 Plus를 사용하는 이유는 멀티모달 입력 때문입니다. OpenAI 비전 API가 사용하는 것과 동일한 형태로 메시지 content 배열에 시각적 콘텐츠를 추가 부분으로 전달합니다.

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "이 양식을 제출하는 버튼은 무엇인가요? 픽셀 좌표를 알려주세요."},
            {"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
        ],
    }],
)

이미지는 공개 URL 또는 base64 데이터 URI로 전달할 수 있습니다. 비디오도 비디오 부분으로 동일한 패턴을 따릅니다. 이것이 GUI-기반 동작을 가능하게 하는 원리입니다. Plus에 스크린샷을 제공하면, click at (x=487, y=232)와 같은 구조화된 작업을 반환합니다. 비디오의 정확한 부분 이름은 지역마다 다를 수 있으므로, 현재 스키마는 OpenAI 호환성 문서를 확인하세요.

가격

Plus는 합리적인 멀티모달 티어로 가격이 책정됩니다. 텍스트 플래그십 모델과 비교하면 다음과 같습니다.

모델	입력 / 100만	출력 / 100만	캐시된 입력 / 100만
Qwen 3.7 Plus	$0.40	$1.60	$0.08
Qwen 3.7 Max	$2.50	$7.50	$0.25

이는 입력 기준으로 Max보다 약 6배 저렴합니다. 영구적인 무료 계층은 없지만, 새로운 Model Studio 계정은 결제가 종량제 방식으로 전환되기 전에 모델을 평가할 수 있는 일회성 무료 토큰 할당량(일반적으로 싱가포르 지역)을 받습니다. 이전 Qwen OAuth 무료 경로는 2026년 4월 15일에 중단되었으므로, 이를 기반으로 개발하지 마세요. 공식적인 수치는 Model Studio 가격 페이지와 무료 할당량 가이드에 나와 있습니다. 더 넓은 범위의 모델을 무료로 시도하는 방법은 Qwen 3.7 무료 가이드를 참조하세요.

실제 요청 비용

텍스트는 저렴합니다. 비전은 비용이 증가하는 부분인데, 이미지와 비디오가 동일한 토큰당 요금과 1백만 컨텍스트 예산을 공유하는 토큰으로 변환되기 때문입니다. 고해상도 스크린샷은 수천 토큰에 달할 수 있으며, 비디오 프레임은 빠르게 쌓입니다.

요청	입력 토큰	출력 토큰	대략적인 비용
텍스트 전용 프롬프트	10,000	2,000	~$0.007
1080p 스크린샷 1개 + 프롬프트	~1,500	300	~$0.001
2fps로 샘플링된 30초 비디오	~77,000	500	~$0.032

프레임-토큰 수치는 대략적이며 해상도와 샘플링 속도에 따라 달라지지만, 교훈은 다음과 같습니다. Plus의 텍스트 에이전트는 거의 비용이 들지 않는 반면, 비디오 중심의 작업은 호출당 30배 더 많은 비용이 들 수 있습니다. 스크린샷을 축소하고 비디오 샘플링을 아껴서 사용하세요. 더 넓은 비용 전략에 대해서는 에이전트 토큰 비용 절감에 대한 저희의 노트와 Plus가 이 가격에 책정된 원인인 2026년 중국 LLM 가격 전쟁을 참조하세요.

속도 제한 및 오류

Model Studio는 분당 요청 수와 분당 토큰 수에 대한 계정별 속도 제한을 적용하며, 상한은 단일 게시된 숫자가 아닌 계정 등급과 지역에 따라 달라집니다. 콘솔의 할당량 페이지에서 현재 제한을 확인하고, 제한에 도달하면 증가를 요청하세요.

일반적인 오류를 처리하는 방법:

401 Unauthorized: 잘못된 키 또는 기본 URL에 대한 잘못된 지역의 키입니다.
429 Too Many Requests: 속도 제한에 도달했습니다. 지수적 지연으로 후퇴하고 다시 시도하세요.
400 Bad Request: 일반적으로 잘못된 멀티모달 페이로드, 너무 큰 이미지 또는 비전 토큰이 계산된 후의 컨텍스트 오버플로입니다.

429 및 5xx 오류 시 후퇴(backoff)와 함께 재시도 루프 내에서 호출을 래핑하고, 전송 전에 이미지 크기를 확인하세요.

Apidog로 API 테스트 및 모의(Mock)

멀티모달 요청은 쉽게 잘못될 수 있습니다. 이미지를 base64로 인코딩하고, 콘텐츠 배열을 중첩하며, 종종 도구 호출 루프 내에서 구조화된 실행 계획을 읽어옵니다. 터미널에서 이를 눈으로 확인하는 것은 빠르게 지겨워집니다.

Apidog는 이를 위한 실제 작업 공간을 제공합니다. 이미지 및 비디오 부분으로 Qwen 3.7 Plus 요청을 보내고, 원시 JSON 응답을 검사하며, 환경별로 Model Studio 키를 저장하여 코드에 붙여넣을 일이 없도록 합니다. 또한 엔드포인트를 모의하여 프롬프트를 조정하는 동안 프런트엔드가 빌드되도록 합니다. Plus가 GUI-및-CLI 에이전트 실행 전반에 걸쳐 도구 호출을 연결할 때, Apidog의 AI 에이전트 디버거는 전체 시퀀스를 보여주어 실행이 중단된 지점을 찾을 수 있도록 합니다.

제품에 연결하기 전에 Qwen 3.7 Plus API를 테스트하고 디버그하며 모의하려면 Apidog를 다운로드하세요.

FAQ

Qwen 3.7 Plus API에 무료 계층이 있나요? 영구적인 무료 계층은 없습니다. 새로운 Alibaba Cloud Model Studio 계정은 일반적으로 싱가포르 지역에서 모델을 평가할 수 있는 일회성 무료 토큰 할당량을 받으며, 그 후에는 종량제 방식으로 요금이 부과됩니다.

모델 ID는 무엇인가요? Model Studio에서 qwen3.7-plus입니다. 식별자는 변경될 수 있으므로, 배포 전에 Model Studio 모델 목록에서 현재 문자열을 확인하세요.

이미지 및 비디오 비용은 어떻게 계산되나요? 시각적 콘텐츠는 표준 입력 요금으로 청구되는 토큰으로 변환됩니다. 1080p 스크린샷은 수천 토큰의 비용이 들 수 있으며, 비디오는 샘플링된 프레임당 토큰을 추가하므로, 대용량 미디어 페이로드가 청구 비용의 대부분을 차지합니다.

API가 Qwen 3.7 Max와 어떻게 다른가요? 동일한 OpenAI 호환 형식과 기본 URL을 사용합니다. Plus는 메시지 콘텐츠에 이미지 및 비디오 부분을 허용하며 비용이 약 6배 저렴합니다. Max는 텍스트 전용이며 순수 텍스트 벤치마크에서 약간의 우위를 유지합니다.

Qwen 3.7 Plus를 자체 호스팅할 수 있나요? 아니요. 가중치가 비공개이므로 Alibaba Cloud Model Studio를 통해서만 실행됩니다.

어떤 기본 URL을 사용해야 하나요? 키를 생성한 지역(싱가포르, 미국(버지니아) 또는 베이징)과 일치하는 URL을 사용해야 합니다. 다른 지역의 엔드포인트에는 키가 인증되지 않습니다.

결론

Qwen 3.7 Plus를 호출하는 것은 OpenAI SDK에서 기본 URL과 키를 교체하는 것과 같습니다. 비전이 필요할 때는 이미지 또는 비디오 부분을 추가합니다. 텍스트에는 정말 저렴한 가격이며 시각적 페이로드에 따라 비용이 증가하므로, 중요한 것은 API 자체가 아니라 얼마나 많은 픽셀을 전송하는가 하는 제어입니다. 키를 얻고, 첫 번째 멀티모달 요청을 보내고, 프로덕션에 연결하기 전에 Apidog에서 전체 흐름을 테스트하세요.

button