Qwen Text Embedding v4 API

alibaba/text-embedding-v4
Qwen Text Embedding v4 is the latest iteration in Alibaba Cloud’s high-performance embedding model series, engineered to transform textual inputs into dense, semantically rich vector representations.
Context
8K tokens
Input
$0.091 / 1M tokens
Output
$0.074 / 1M tokens
Released
Dec 13, 2025

Overview

Overview

Qwen Text Embedding v4 is a 4B-parameter dual-encoder model from the Qwen3 family, optimized specifically for dense embeddings and ranking tasks rather than general chat. It supports over 100 languages (including major programming languages) and is tuned for semantic search, retrieval, classification, clustering, and bitext mining in a single shared embedding space.

Technical Specifications

  • Architecture: Dense transformer-based encoder with symmetric contrastive fine-tuning
  • Context Length: 8,192 tokens
  • Capabilities: Multilingual semantic encoding, query/document alignment, cross-lingual retrieval, similarity ranking
  • Training Data: Curated corpus spanning technical documentation, academic papers, conversational logs, and web-scale multilingual text with rigorous deduplication and bias mitigation

Performance Benchmarks

  • MTEB (Massive Text Embedding Benchmark): Achieves top-tier performance among open and closed models, excelling in retrieval, classification, and clustering subtasks
  • Multilingual Alignment: Maintains >92% cross-lingual similarity fidelity on aligned sentence pairs across major language families

Quality Improvements

  • Semantic Density: Embeddings exhibit tighter intra-cluster cohesion and sharper inter-cluster separation compared to v3
  • Noise Resilience: Robust to input perturbations, formatting inconsistencies, and moderate grammatical errors
  • Bias Control: Integrated fairness-aware training reduces spurious correlations in gender, region, and domain-sensitive dimensions

API Pricing

  • $0.0735 / 1M tokens

New Features & Technical Upgrades

Qwen Text Embedding v4 introduces a suite of innovations focused on semantic fidelity, efficiency, and multilingual equity:

Key Features

  • High Semantic Fidelity: Captures fine-grained semantic relationships, even in complex or domain-specific phrasing.
  • Long-Context Awareness: Handles inputs up to 8K tokens—ideal for embedding full documents or detailed user queries.
  • Multilingual Robustness: Unified embedding space across languages enables cross-lingual retrieval without translation.
  • Optimized for Retrieval: Trained with contrastive and in-batch negative sampling for superior performance in similarity search.
  • Low Latency & High Throughput: Efficient inference pipeline suitable for real-time applications at scale.

Practical Impact

‍These enhancements translate into stronger RAG accuracy, more coherent document clustering, and reduced false positives in semantic search, especially in multilingual support portals, research knowledge bases, and cross-border enterprise analytics.

Code Sample

Comparison with Other Models

vs OpenAI text-embedding-3-large: Qwen v4 matches or exceeds OpenAI’s performance on MTEB while offering 8K context (vs 8K for OpenAI, but with lower cost and data residency flexibility). Unlike OpenAI, Qwen provides transparent licensing for commercial deployment and avoids data usage for model training.

vs Google’s textembedding-gecko: Qwen v4 provides better zero-shot retrieval scores on BEIR and avoids vendor lock-in through open-weight availability. Gecko integrates tightly with Vertex AI, while Qwen offers greater deployment flexibility across clouds and on-prem.

Uptime and performance

  • Uptime (7d): 22.0%

Measured on the AI/ML API gateway across live traffic. Figures are medians unless stated. Last updated 2026-10-12.

Use cases

  • Semantic Search: Enable meaning-based search in e-commerce, knowledge bases, and customer support.
  • Recommendation Systems: Embed user queries and product descriptions into shared vector space.
  • Duplicate Detection & Clustering: Group similar support tickets, news articles, or user reviews.
  • Cross-Lingual Applications: Build multilingual chatbots or global search engines without per-language models.

‍

How to use Qwen Text Embedding v4 API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to alibaba/text-embedding-v4.
import requests

r = requests.post(
    "https://api.aimlapi.com/v1/embeddings",
    headers={"Authorization": "Bearer " + AIMLAPI_KEY},
    json={
      "model": "alibaba/text-embedding-v4",
      "input": "The quick brown fox"
    },
)
print(r.json())
const r = await fetch("https://api.aimlapi.com/v1/embeddings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "alibaba/text-embedding-v4",
    "input": "The quick brown fox"
  }),
});
console.log(await r.json());
curl -X POST https://api.aimlapi.com/v1/embeddings \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"alibaba/text-embedding-v4","input":"The quick brown fox"}'

OpenAI-compatible — swap the base URL and it works with your existing SDK.

Qwen Text Embedding v4 API Pricing

TypePrice
Input
$0.091 / 1M tokens
Output
$0.074 / 1M tokens

Qwen Text Embedding v4 vs other models

ModelInputOutputContextBest for
$0.091 / 1M tokens
$0.074 / 1M tokens
8K tokens
Semantic search + RAG
$0.169 / 1M tokens
8K tokens
Semantic search + RAG
$0.026 / 1M tokens
8K tokens
Semantic search + RAG
$0.13 / 1M tokens
4K tokens
Semantic search + RAG

Frequently asked questions

Qwen Text Embedding v4 takes text as input and returns embedding.

Qwen Text Embedding v4 became available on December 13, 2025.

Qwen Text Embedding v4 is priced at input $0.091 / 1M tokens, output $0.074 / 1M tokens.

Qwen Text Embedding v4 was built by Alibaba Cloud.

Send a request to https://api.aimlapi.com/v1/embeddings with alibaba/text-embedding-v4 as the model id.

Yes. Qwen Text Embedding v4 is served through AI/ML API, so the same key and endpoint format used for other models applies.

Qwen Text Embedding v4 supports custom embedding dimensions ranging from 64 to 2048.

Qwen Text Embedding v4 supports over 100 languages.

Yes, it belongs to the Qwen3-Embedding series from Alibaba Cloud.

It is designed for semantic search, clustering, and classification tasks.

Start building with Qwen Text Embedding v4

Get API Key
1000+ models, one API.