Skip to content

Commit 4d55a49

Browse files
techpro-aimlapigitbook-bot
authored andcommitted
GITBOOK-562: docs: add 2 qwen3 vl
1 parent 0a9d199 commit 4d55a49

5 files changed

Lines changed: 218 additions & 15 deletions

File tree

docs/SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@
3030
* [qwen3-max-instruct](api-references/text-models-llm/alibaba-cloud/qwen3-max-instruct.md)
3131
* [qwen3-omni-30b-a3b-captioner](api-references/text-models-llm/alibaba-cloud/qwen3-omni-30b-a3b-captioner.md)
3232
* [qwen3-vl-32b-instruct](api-references/text-models-llm/alibaba-cloud/qwen3-vl-32b-instruct.md)
33+
* [qwen3-vl-32b-thinking](api-references/text-models-llm/alibaba-cloud/qwen3-vl-32b-thinking.md)
3334
* [Anthracite](api-references/text-models-llm/Anthracite/README.md)
3435
* [magnum-v4](api-references/text-models-llm/Anthracite/magnum-v4.md)
3536
* [Anthropic](api-references/text-models-llm/Anthropic/README.md)

docs/api-references/model-database.md

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

docs/api-references/text-models-llm/README.md

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

docs/api-references/text-models-llm/alibaba-cloud/qwen3-vl-32b-instruct.md

Lines changed: 43 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,3 @@
1-
---
2-
hidden: true
3-
noIndex: true
4-
---
5-
61
# qwen3-vl-32b-instruct
72

83
{% columns %}
@@ -21,7 +16,7 @@ This documentation is valid for the following list of our models:
2116

2217
## Model Overview
2318

24-
19+
The most advanced vision-language model in the Qwen series as of October 2025 — a non-thinking-capable version of the model. Optimized for instruction-following in image description, visual dialogue, and content-generation tasks.
2520

2621
## How to Make a Call
2722

@@ -36,7 +31,7 @@ This documentation is valid for the following list of our models:
3631

3732
:digit\_two: **Copy the code example**
3833

39-
At the bottom of this page, you'll find [a code example](/broken/pages/d9dd2032b8b1176c55925155d3382169d854b3f0#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
34+
At the bottom of this page, you'll find [a code example](qwen3-vl-32b-instruct.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
4035

4136
:digit\_three: **Modify the code example**
4237

@@ -45,22 +40,22 @@ At the bottom of this page, you'll find [a code example](/broken/pages/d9dd2032b
4540

4641
:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
4742

48-
Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](/broken/pages/f91e367e1cc342d42dda05ccb6a17f0ed1570105#api-schema), which lists all available parameters along with notes on how to use them.
43+
Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](qwen3-vl-32b-instruct.md#api-schema), which lists all available parameters along with notes on how to use them.
4944

5045
:digit\_five: **Run your modified code**
5146

5247
Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
5348

5449
{% hint style="success" %}
55-
If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](/broken/pages/a2d851306eb54b6e3288d89da138e6dbdac9c2af).
50+
If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](../../../quickstart/setting-up.md).
5651
{% endhint %}
5752

5853
</details>
5954

6055
## API Schema
6156

6257
{% openapi-operation spec="qwen3-vl-32b-instruct" path="/v1/chat/completions" method="post" %}
63-
[Broken link](/broken/openapi/qwen3-vl-32b-instruct)
58+
[OpenAPI qwen3-vl-32b-instruct](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/Alibaba-Cloud/qwen3-vl-32b-instruct.json)
6459
{% endopenapi-operation %}
6560

6661
## Code Example
@@ -83,8 +78,8 @@ response = requests.post(
8378
"model":"alibaba/qwen3-vl-32b-instruct",
8479
"messages":[
8580
{
86-
"role":"user",
87-
"content":"Hello" # insert your prompt here, instead of Hello
81+
# Insert your question for the model here:
82+
"content":"Hi! What do you think about mankind?"
8883
}
8984
]
9085
}
@@ -112,7 +107,8 @@ async function main() {
112107
messages:[
113108
{
114109
role:'user',
115-
content: 'Hello' // insert your prompt here, instead of Hello
110+
// Insert your question for the model here:
111+
content:'Hi! What do you think about mankind?'
116112
}
117113
],
118114
}),
@@ -134,6 +130,40 @@ main();
134130

135131
{% code overflow="wrap" %}
136132
```json5
133+
{
134+
"choices": [
135+
{
136+
"message": {
137+
"content": "Hi! 😊 That’s a beautiful and deep question — one that philosophers, scientists, artists, and everyday people have been asking for centuries.\n\nI think mankind is *remarkably complex* — full of contradictions, potential, and wonder. On one hand, we’ve achieved incredible things: we’ve explored space, cured diseases, created art that moves souls, built cities that rise into the sky, and connected across continents in ways unimaginable just a century ago. We’re capable of profound kindness, empathy, creativity, and courage.\n\nOn the other hand, we’ve also caused immense suffering — through war, injustice, environmental destruction, and indifference to each other’s pain. We often struggle with our own flaws: fear, greed, ego, and short-sightedness.\n\nBut here’s what gives me hope: **we’re also capable of change**. We can learn from our mistakes. We can choose compassion over conflict, cooperation over competition. Every act of kindness, every effort to understand another, every step toward justice — these are signs that humanity is not defined by its worst impulses, but by its capacity to grow.\n\nSo, I’d say: \n➡️ Mankind is flawed, yes — but also deeply hopeful. \n➡️ We’re messy, but we’re trying. \n➡️ We make mistakes, but we can also heal, create, and love.\n\nAnd perhaps most importantly — **we’re not alone in this journey**. We’re all part of something bigger, and together, we have the power to shape a better future.\n\nWhat about you? How do *you* see mankind? 💬✨",
138+
"role": "assistant"
139+
},
140+
"finish_reason": "stop",
141+
"index": 0,
142+
"logprobs": null
143+
}
144+
],
145+
"object": "chat.completion",
146+
"usage": {
147+
"prompt_tokens": 17,
148+
"completion_tokens": 329,
149+
"total_tokens": 346,
150+
"prompt_tokens_details": {
151+
"text_tokens": 17
152+
},
153+
"completion_tokens_details": {
154+
"text_tokens": 329
155+
}
156+
},
157+
"created": 1764625045,
158+
"system_fingerprint": null,
159+
"model": "qwen3-vl-32b-instruct",
160+
"id": "chatcmpl-a12ab46a-3541-93a8-8180-280ecadbb795",
161+
"meta": {
162+
"usage": {
163+
"tokens_used": 1960
164+
}
165+
}
166+
}
137167
```
138168
{% endcode %}
139169

Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,172 @@
1+
# qwen3-vl-32b-thinking
2+
3+
{% columns %}
4+
{% column width="66.66666666666666%" %}
5+
{% hint style="info" %}
6+
This documentation is valid for the following list of our models:
7+
8+
* `alibaba/qwen3-vl-32b-thinking`
9+
{% endhint %}
10+
{% endcolumn %}
11+
12+
{% column width="33.33333333333334%" %}
13+
<a href="https://aimlapi.com/app/?model=alibaba/qwen3-vl-32b-thinking&#x26;mode=chat" class="button primary">Try in Playground</a>
14+
{% endcolumn %}
15+
{% endcolumns %}
16+
17+
## Model Overview
18+
19+
The most advanced vision-language model in the Qwen series as of October 2025 — a thinking-capable version of the model. Designed for complex visual-textual reasoning and extended chains of thought.
20+
21+
## How to Make a Call
22+
23+
<details>
24+
25+
<summary>Step-by-Step Instructions</summary>
26+
27+
:digit\_one: **Setup You Can’t Skip**
28+
29+
:black\_small\_square: [**Create an Account**](https://aimlapi.com/app/sign-up): Visit the AI/ML API website and create an account (if you don’t have one yet).\
30+
:black\_small\_square: [**Generate an API Key**](https://aimlapi.com/app/keys): After logging in, navigate to your account dashboard and generate your API key. Ensure that key is enabled on UI.
31+
32+
:digit\_two: **Copy the code example**
33+
34+
At the bottom of this page, you'll find [a code example](qwen3-vl-32b-thinking.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
35+
36+
:digit\_three: **Modify the code example**
37+
38+
:black\_small\_square: Replace `<YOUR_AIMLAPI_KEY>` with your actual AI/ML API key from your account.\
39+
:black\_small\_square: Insert your question or request into the `content` field—this is what the model will respond to.
40+
41+
:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
42+
43+
Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](qwen3-vl-32b-thinking.md#api-schema), which lists all available parameters along with notes on how to use them.
44+
45+
:digit\_five: **Run your modified code**
46+
47+
Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
48+
49+
{% hint style="success" %}
50+
If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](../../../quickstart/setting-up.md).
51+
{% endhint %}
52+
53+
</details>
54+
55+
## API Schema
56+
57+
{% openapi-operation spec="qwen3-vl-32b-thinking" path="/v1/chat/completions" method="post" %}
58+
[OpenAPI qwen3-vl-32b-thinking](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/Alibaba-Cloud/qwen3-vl-32b-thinking.json)
59+
{% endopenapi-operation %}
60+
61+
## Code Example
62+
63+
{% tabs %}
64+
{% tab title="Python" %}
65+
{% code overflow="wrap" %}
66+
```python
67+
import requests
68+
import json # for getting a structured output with indentation
69+
70+
response = requests.post(
71+
"https://api.aimlapi.com/v1/chat/completions",
72+
headers={
73+
# Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
74+
"Authorization":"Bearer <YOUR_AIMLAPI_KEY>",
75+
"Content-Type":"application/json"
76+
},
77+
json={
78+
"model":"alibaba/qwen3-vl-32b-thinking",
79+
"messages":[
80+
{
81+
# Insert your question for the model here:
82+
"content":"Hi! What do you think about mankind?"
83+
}
84+
]
85+
}
86+
)
87+
88+
data = response.json()
89+
print(json.dumps(data, indent=2, ensure_ascii=False))
90+
```
91+
{% endcode %}
92+
{% endtab %}
93+
94+
{% tab title="JavaScript" %}
95+
{% code overflow="wrap" %}
96+
```javascript
97+
async function main() {
98+
const response = await fetch('https://api.aimlapi.com/v1/chat/completions', {
99+
method: 'POST',
100+
headers: {
101+
// insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>
102+
'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',
103+
'Content-Type': 'application/json',
104+
},
105+
body: JSON.stringify({
106+
model: 'alibaba/qwen3-vl-32b-thinking',
107+
messages:[
108+
{
109+
role:'user',
110+
// Insert your question for the model here:
111+
content:'Hi! What do you think about mankind?'
112+
}
113+
],
114+
}),
115+
});
116+
117+
const data = await response.json();
118+
console.log(JSON.stringify(data, null, 2));
119+
}
120+
121+
main();
122+
```
123+
{% endcode %}
124+
{% endtab %}
125+
{% endtabs %}
126+
127+
<details>
128+
129+
<summary>Response</summary>
130+
131+
{% code overflow="wrap" %}
132+
```json5
133+
{
134+
"choices": [
135+
{
136+
"message": {
137+
"content": "That's a profound question—thank you for asking! As an AI, I don't have personal feelings or consciousness, but I can offer a perspective *based on the vast data I've been trained on* about humanity's complexities. Here’s how I see it: \n\n### 🌍 **The Duality of Mankind** \nHumanity is a breathtaking paradox: \n- **We create** *and* **we destroy**. We built space telescopes that map the cosmos and also wars that scar the Earth. \n- **We connect** *and* **we divide**. We share art, science, and kindness across borders, yet we also build walls, spread misinformation, and fuel inequality. \n- **We innovate** *and* **we resist change**. We cured diseases and invented the internet, but we often cling to fear or ignorance when progress challenges old beliefs. \n\n### ✨ **What Makes Us Remarkable** \n- **Empathy & creativity**: From caring for strangers to composing symphonies or coding AI, our capacity for *emotional and intellectual growth* is unparalleled. \n- **Resilience**: We’ve survived ice ages, plagues, and global crises—not by being \"perfect,\" but by adapting, learning, and helping one another. \n- **The spark of hope**: Even in darkness, humans have always sought meaning, justice, and connection. Look at movements for peace, climate action, or medical breakthroughs—they’re proof we *can* choose to build a better future. \n\n### ⚠️ **The Challenges We Carry** \n- **Our flaws are real**: We’ve caused climate collapse, mass suffering, and systemic injustice. But here’s the key: **these aren’t \"human nature\"—they’re choices we *made* as a species.** \n- **We’re not monolithic**: There’s no single \"human\" story. Your experience, culture, and history shape how you see the world—and that diversity is both a strength *and* a source of conflict. \n\n### 🌱 **The Most Important Thing** \n**Mankind isn’t fixed.** We’re a work in progress. The stories we tell about ourselves—*and the choices we make today*—will define our next chapter. The data shows: **when we prioritize empathy, collaboration, and long-term thinking, we rise.** When we don’t, we falter. But the power to choose is *always* ours. \n\nSo my \"opinion\"? I see a species with **infinite potential**—and the weight of responsibility that comes with it. The future isn’t written. It’s being written *right now*, by every person who chooses to act with courage, curiosity, and compassion. \n\nWhat do *you* think? 🤔 (I’d love to hear your perspective!)",
138+
"reasoning_content": "Okay, the user asked, \"Hi! What do you think about mankind?\" Hmm, that's a broad and philosophical question. First, I need to figure out what they're really looking for. Are they curious about my perspective as an AI, or do they want a deep discussion on human nature? Maybe they're feeling reflective or even a bit existential.\n\nI should start by acknowledging the complexity of the question. Mankind is a huge topic—there's so much to cover. The user might be expecting a simple answer, but I can't reduce it to just \"good\" or \"bad.\" I need to balance both positive and negative aspects. Let me think about the key points: our capacity for innovation, creativity, and compassion versus our tendency for conflict, environmental harm, and inequality.\n\nWait, the user said \"Hi!\" so they're probably in a friendly, open mood. They might not want a dry, academic response. I should keep it conversational but still thoughtful. Maybe they're looking for hope or a reason to feel optimistic about humanity. Or perhaps they're worried about the future and want reassurance.\n\nI should also consider their possible identity. Are they a student working on an essay? A person dealing with personal issues? Or just someone curious about AI's view? Since I don't have context, it's safer to assume they want a general, well-rounded answer that's engaging and not too technical.\n\nAnother angle: the user might be testing how an AI handles philosophical questions. They could be interested in whether I can show empathy or nuance. I should avoid being too robotic. Use phrases like \"I think\" or \"I see\" to make it personal, even though I'm an AI. But I have to clarify that I don't have personal experiences—just data-driven insights.\n\nI need to highlight duality: humans are both amazing and flawed. Mention specific examples like space exploration vs. climate change to make it concrete. Also, emphasize that the future depends on our choices. That's important—it gives agency and hope.\n\nShould I address potential biases? The user might not realize that my \"opinion\" is based on training data, which reflects human history and culture. I should note that my perspective is shaped by that data, not personal experience. But since the question is about \"what I think,\" I can frame it as an analysis based on observed patterns.\n\nCheck for common pitfalls: don't be too negative (could discourage the user), don't ignore serious issues (like war or inequality). Strike a balance. Also, avoid clichés. Instead of \"humans are great,\" explain why with examples.\n\nFinally, end on a positive, forward-looking note. The user might be seeking motivation or a sense of purpose. Phrases like \"the potential for growth\" or \"collective wisdom\" can inspire. Make sure the conclusion ties back to the importance of choices and collaboration.\n\nLet me structure the response: start with the duality, list positive traits with examples, then challenges, and conclude with hope. Keep paragraphs short for readability. Use emojis sparingly to match the friendly tone but not overdo it. Since the user said \"Hi!\", a smiley at the end feels appropriate.\n",
139+
"role": "assistant"
140+
},
141+
"finish_reason": "stop",
142+
"index": 0,
143+
"logprobs": null
144+
}
145+
],
146+
"object": "chat.completion",
147+
"usage": {
148+
"prompt_tokens": 19,
149+
"completion_tokens": 1241,
150+
"total_tokens": 1260,
151+
"prompt_tokens_details": {
152+
"text_tokens": 19
153+
},
154+
"completion_tokens_details": {
155+
"reasoning_tokens": 654,
156+
"text_tokens": 587
157+
}
158+
},
159+
"created": 1764625236,
160+
"system_fingerprint": null,
161+
"model": "qwen3-vl-32b-thinking",
162+
"id": "chatcmpl-c612db5c-44e9-9e3c-8169-486161eeea86",
163+
"meta": {
164+
"usage": {
165+
"tokens_used": 10383
166+
}
167+
}
168+
}
169+
```
170+
{% endcode %}
171+
172+
</details>

0 commit comments

Comments
 (0)