Back to Models

text-embedding-v3 is Qwen's generation-3 general-purpose multilingual text embedding model. It produces dense vectors for retrieval, semantic search, clustering, classification, and RAG indexing across Chinese, English, and other major languages.

If you are starting a new project, prefer text-embedding-v4 β€” v3 is kept here for compatibility with existing indices and pipelines built before the v4 release. TheRouter routes between bailian-cn and bailian-sg per request based on cost.

Multilingual
Trained across Chinese, English, and other major languages with consistent vector geometry.
8K input window
Embed long passages without aggressive chunking β€” covers most RAG document slices.
OpenAI-compatible
Standard `/v1/embeddings` shape β€” drop into existing OpenAI embedding pipelines.
Dual-region routing
Selector picks bailian-cn or bailian-sg per request based on cost.
When to use
Existing RAG pipelines and indices already built on Qwen v3 embeddings, or projects that must stay vector-compatible with a prior corpus.
When not to use
New projects β€” use text-embedding-v4 for higher quality at the same price.
Pricing: $0.12 per MTok of input. TheRouter routes to the cheaper of bailian-cn / bailian-sg per request.
Context Length
8K
Max Output
--
Input Priceper 1M tokens
$0.0756/ 1M tokens

Modalities

text→embedding

Pricing Breakdown

TypeRate
Input$0.0756 / 1M tokens

Supported Parameters

inputdimensionsencoding_format

Specifications

Model familyAlibaba Cloud text-embedding v3help.aliyun.com β†—verified
Embedding dimensions64, 128, 256, 512, 768, or 1,024 (default)help.aliyun.com β†—verified
Supported languagesChinese, English, Spanish, French, Portuguese, Indonesian, Japanese, Korean, German, Russian, and 50+ other major languageshelp.aliyun.com β†—verified
TheRouter context length8,192 tokenstherouter.ai β†—verified
TheRouter input price$0.144 per 1M input tokenstherouter.ai β†—verified
Alibaba Cloud public-cloud API compatibilityOpenAI-compatible /v1/embeddings and DashScope native APIshelp.aliyun.com β†—verified
Primary endpoint on TheRouterPOST /v1/embeddingstherouter.ai β†—verified
Successor modelqwen/text-embedding-v4qwenlm.github.io β†—verified
Parameter countNot publicly disclosed in Alibaba's Model Studio v3 docsunknown
Training cutoffNot publicly disclosedunknown
LicenseNot publicly disclosed for the hosted API modelunknown

Benchmarks

BenchmarkDistributionScoreSource
Alibaba Cloud documented embedding tasks
Alibaba documents the model for semantic search, recommendation, clustering, and classification but does not publish a benchmark table for text-embedding-v3 on the API page.
β€”Not publicly disclosedβ€”

API Usage Examples

Use the global api.therouter.ai endpoint shown below for new integrations; the legacy China accelerated endpoint is retired.

cURL
curl https://api.therouter.ai/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer $THE_ROUTER_API_KEY"   -d '{
    "model": "qwen/text-embedding-v3",
    "messages": [
      {"role": "user", "content": "Summarize the key points from this input."}
    ]
  }'

API guide

Embeddings request

Generate dense vectors through TheRouter's OpenAI-compatible /v1/embeddings endpoint. Use dimensions to trade recall quality against vector storage and ANN index size.

cURL
curl https://api.therouter.ai/v1/embeddings \
  -H "Authorization: Bearer $THEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/text-embedding-v3",
    "input": [
      "TheRouter routes embedding requests through one OpenAI-compatible API.",
      "Qwen text-embedding-v3 supports configurable vector dimensions."
    ],
    "encoding_format": "float",
    "dimensions": 1024
  }'

More from qwen

Similar models

Cross-provider sibling models

News & changes

2025-06-05

Qwen3 Embedding arrives as the v4 successor path

Alibaba Qwen introduced the Qwen3 Embedding and Reranker series with stronger multilingual retrieval positioning. For TheRouter users this matters because qwen/text-embedding-v4 is the practical successor for new indexes, while v3 remains the compatibility model for existing vector spaces.

re-authored by TheRouterqwenlm.github.io β†—

Frequently asked

Should I use text-embedding-v3 or text-embedding-v4?

Use v3 when you already have vectors generated with v3 and cannot reindex immediately. Use v4 for new projects or migrations where you can re-embed all documents and queries with one model generation.

re-authored by TheRouterqwenlm.github.io β†—
Can I change the embedding dimension?

Yes. Alibaba Cloud documents dimensions support for text-embedding-v3 with 64, 128, 256, 512, 768, and 1,024 dimensions. Keep the same dimension across an index; changing it requires a new vector field or a reindex.

re-authored by TheRouterhelp.aliyun.com β†—
Does text-embedding-v3 support OpenAI-compatible clients?

Yes. Alibaba documents an OpenAI-compatible embeddings API for text embedding models, and TheRouter exposes the same integration style through https://api.therouter.ai/v1 with model ID qwen/text-embedding-v3.

re-authored by TheRouterhelp.aliyun.com β†—
Can I mix v3 and v4 vectors in the same vector database index?

No. Treat each embedding model generation and dimension as a separate vector space. If you migrate from v3 to v4, rebuild the index with v4 embeddings rather than appending v4 vectors beside v3 vectors.

re-authored by TheRouterqwenlm.github.io β†—
Fact ledger β€” every claim on this page traces here
sourceURLretrieved
Model familyhelp.aliyun.com β†—2026-07-24verified
Embedding dimensionshelp.aliyun.com β†—2026-07-24verified
Supported languageshelp.aliyun.com β†—2026-07-24verified
TheRouter context lengththerouter.ai β†—2026-07-24verified
TheRouter input pricetherouter.ai β†—2026-07-24verified
Alibaba Cloud public-cloud API compatibilityhelp.aliyun.com β†—2026-07-24verified
Primary endpoint on TheRoutertherouter.ai β†—2026-07-24verified
Successor modelqwenlm.github.io β†—2026-07-24verified
Parameter countβ€”β€”unknown
Training cutoffβ€”β€”unknown
Licenseβ€”β€”unknown
Alibaba Cloud documented embedding taskshelp.aliyun.com β†—2026-07-24unknown
Qwen3 Embedding arrives as the v4 successor pathqwenlm.github.io β†—2026-07-24verified
Should I use text-embedding-v3 or text-embedding-v4?qwenlm.github.io β†—2026-07-24to verify
Can I change the embedding dimension?help.aliyun.com β†—2026-07-24to verify
Does text-embedding-v3 support OpenAI-compatible clients?help.aliyun.com β†—2026-07-24to verify
Can I mix v3 and v4 vectors in the same vector database index?qwenlm.github.io β†—2026-07-24to verify
Help & contact