> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# Qwen4 Max

> Next-generation Qwen flagship for coding, frontend design, office work, and complex agents, with image and video understanding across a 1M-token context.

![Qwen4 Max](https://media.empiriolabs.ai/model-logos/qwen.png)

[Alibaba Cloud](/providers/alibaba) · Text Generation

`POST /v1/chat/completions`

Next-generation Qwen flagship for coding, frontend design, office work, and complex agents, with image and video understanding across a 1M-token context.

## At a glance

| Field               | Value                                                                                                                   |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Model id            | `qwen4-max`                                                                                                             |
| Model release date  | 2026-11-16                                                                                                              |
| Input modalities    | Text, Image, Video                                                                                                      |
| Output modalities   | Text                                                                                                                    |
| Context window      | 983.6K                                                                                                                  |
| Weight precision    | -                                                                                                                       |
| Max output tokens   | 262,144                                                                                                                 |
| Region              | Singapore                                                                                                               |
| Features            | reasoning, vision, multimodal, web_search, code_interpreter, function_calling, structured_output, agentic_coding, cache |
| Native inference    | No                                                                                                                      |
| New                 | Yes                                                                                                                     |
| Structured output   | JSON Schema                                                                                                             |
| Supported endpoints | `POST /v1/chat/completions`, `POST /v1/responses`, `POST /v1/messages`, `POST /v1beta/models/qwen4-max:generateContent` |

## Pricing

| Charge                | Spec                       | Rate    |
| --------------------- | -------------------------- | ------- |
| Input                 | per 1M prompt tokens       | \$1.50  |
| Output                | per 1M generated tokens    | \$4.50  |
| Implicit cache read   | per 1M cached input tokens | \$0.075 |
| Web search            | per call when invoked      | \$0.02  |
| Text-to-image search  | per call when invoked      | \$0.02  |
| Image-to-image search | per call when invoked      | \$0.02  |
| Web extractor         | per call when invoked      | \$0.00  |
| Code interpreter      | per call when invoked      | \$0.00  |

## Example request

```bash
curl https://api.empiriolabs.ai/v1/chat/completions \
  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "qwen4-max", "messages": [{"role":"user","content":"Hello"}]}'
```

## Parameters

| Parameter                   | Type    | Required | Default   | Description                                                                                                                                                                                                                                                                           |
| --------------------------- | ------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `temperature`               | number  | no       | `0.7`     | Sampling temperature. 0 is deterministic and 1.99 is maximum randomness. · Range: 0 – 1.99                                                                                                                                                                                            |
| `top_p`                     | number  | no       | `0.9`     | Nucleus sampling probability mass. Lower values make outputs more focused. · Range: 0 – 1                                                                                                                                                                                             |
| `max_tokens`                | number  | no       | -         | Maximum output tokens, reasoning included. When omitted, the model's own default applies. · Range: 1 – 262144                                                                                                                                                                         |
| `stop`                      | string  | no       | -         | Up to 4 strings where the model will stop generating further tokens.                                                                                                                                                                                                                  |
| `enable_thinking`           | boolean | no       | true      | Enable reasoning before answering.                                                                                                                                                                                                                                                    |
| `reasoning_effort`          | enum    | no       | `"high"`  | Reasoning depth while thinking is on: low, high, or xhigh. Higher effort spends more reasoning tokens before answering. The default is high. low and xhigh cannot be combined with thinking_budget. · Allowed: `low`, `high`, `xhigh`                                                 |
| `thinking_budget`           | number  | no       | -         | Maximum tokens reserved for reasoning when thinking is enabled. When omitted, the model decides how long to reason. Runs at the default reasoning effort and cannot be combined with low or xhigh. Not used when a built-in tool is on, or on /v1/responses. · Range: 1 – 262144      |
| `preserve_thinking`         | boolean | no       | true      | Include the reasoning of earlier assistant turns in the model's input on /v1/chat/completions. Return each turn's reasoning unchanged in that assistant message's reasoning_content field. The earlier reasoning is billed as input tokens. Not available when a built-in tool is on. |
| `seed`                      | integer | no       | -         | Random seed for more reproducible sampling. Reusing a seed with the same request returns similar, not always identical, output. · Range: 0 – 2147483647                                                                                                                               |
| `top_k`                     | integer | no       | -         | Sample only from the K most likely tokens. When omitted, the model's own default applies. · Range: 1 – 100                                                                                                                                                                            |
| `presence_penalty`          | number  | no       | -         | Penalty for tokens that already appeared in the generated text. Positive values encourage new topics. When omitted, the model's own default applies. · Range: -2 – 2                                                                                                                  |
| `repetition_penalty`        | number  | no       | -         | Higher values discourage repeated phrasing, and 1 applies no penalty. When omitted, the model's own default applies. Not available when a built-in tool is on, or on /v1/responses. · Range: 0.1 – 2                                                                                  |
| `n`                         | integer | no       | `1`       | Number of answers to return. Above 1 runs only on /v1/chat/completions, with enable_thinking false and without tools, web search or logprobs. The output tokens of every answer are billed. · Range: 1 – 4                                                                            |
| `logprobs`                  | boolean | no       | false     | Return the log probabilities of the answer tokens, not the reasoning, on /v1/chat/completions. Not available when a built-in tool is on.                                                                                                                                              |
| `top_logprobs`              | integer | no       | `0`       | Return up to this many most likely alternatives for each answer token. Needs logprobs set to true. · Range: 0 – 5                                                                                                                                                                     |
| `vl_high_resolution_images` | boolean | no       | true      | Use higher resolution processing for image inputs. Applies when no built-in tool is enabled, and not on /v1/responses.                                                                                                                                                                |
| `max_pixels`                | number  | no       | `2621440` | Maximum pixel count per image when high resolution processing is disabled. · Range: 4096 – 16777216                                                                                                                                                                                   |
| `video_fps`                 | number  | no       | `2`       | Frames per second to sample from video inputs. · Range: 0.1 – 10                                                                                                                                                                                                                      |
| `treat_images_as_video`     | boolean | no       | false     | Treat a sequence of images as video frames.                                                                                                                                                                                                                                           |
| `tool_web_search`           | boolean | no       | false     | Search the web for real-time information. Adds \$0.02 to the request cost for each invoked call. Not used when the request also has function tools, response_format or video input.                                                                                                   |
| `tool_web_extractor`        | boolean | no       | false     | Extract and read content from URLs. Requires Web Search and Thinking. Not used when the request also has function tools, response_format or video input.                                                                                                                              |
| `tool_code_interpreter`     | boolean | no       | false     | Run Python code in a sandbox. Requires Thinking. Not used when the request also has function tools, response_format or video input.                                                                                                                                                   |
| `tool_web_search_image`     | boolean | no       | false     | Search the web for images from text descriptions. Adds \$0.02 to the request cost for each invoked call. Not used when the request also has function tools, response_format or video input.                                                                                           |
| `tool_image_search`         | boolean | no       | false     | Find similar images from an uploaded image. Adds \$0.02 to the request cost for each invoked call. Not used when the request also has function tools, response_format or video input.                                                                                                 |
| `parallel_tool_calls`       | boolean | no       | -         | Allow multiple tool calls in a single assistant turn. When omitted, the model's own default applies.                                                                                                                                                                                  |
| `disable_formatting`        | boolean | no       | false     | Return the answer without EmpirioLabs formatting: citations stay as plain \[N] markers and no References block is added. Applies to streamed responses that use a built-in tool.                                                                                                      |
| `response_format`           | enum    | no       | -         | Constrain the output to valid JSON. Use JSON mode for any JSON object, or supply a JSON Schema to force an exact response shape.                                                                                                                                                      |

## Notes

Text, image, and video input are supported. Web search, web extractor, code interpreter, text-to-image search, and image-to-image search are optional built-in tools exposed through tool\_\* parameters. Web search, text-to-image search, and image-to-image search add \$0.02 for each invoked call; web extractor and code interpreter run at no extra cost. Web extractor requires web search, and both web extractor and code interpreter require thinking. A single request can invoke a tool more than once, and each invoked call is billed. Thinking is on by default; reasoning_effort sets its depth (low, high, or xhigh, default high), and thinking tokens are billed as output tokens. max_tokens and max_completion_tokens cap reasoning and answer together. Repeated prompt prefixes are cached automatically, and cached input tokens bill at the implicit cache read rate. Explicit cache controls such as cache_control are not supported.

**Per-tool billing (`usage.tool_usage`)**

When this model invokes built-in tools inside a single request, the response carries a normalized `usage.tool_usage` map alongside the token counts:

```json
"usage": {
  "prompt_tokens": 123,
  "completion_tokens": 456,
  "cost_usd": 0.0042,
  "tool_usage": {"web_search": 3, "code_interpreter": 1}
}
```

Tool counts are already factored into `cost_usd` and are surfaced for transparency so you can audit per-tool billing. The field is omitted when no tools were invoked.

---

*Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/qwen4-max`.