models

Qwen: Qwen3 Embedding 4B

Markdown · JSON

Qwen: Qwen3 Embedding 4B

Qwen3-Embedding-4B представляет текст в виде семантических векторов для многоязычного поиска, поиска по коду, классификации и кластеризации. Эта модель 4B поддерживает последовательности длиной 32K токенов и выбор размерности вектора от 32 до 2 560.

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Qwen3-Embedding-4B — версия 4B для текстовых эмбеддингов в семействе моделей Qwen для эмбеддингов и переранжирования. Построенная на базовой плотной модели Qwen3, она преобразует текстовый фрагмент в числовое представление его смысла. Qwen относит к областям применения поиск текстов, поиск по коду, классификацию, кластеризацию и поиск параллельных текстов. Она полезна, когда приложению нужно находить связанные фрагменты, группировать похожие записи или сопоставлять тексты на разных языках. Результат модели — вектор эмбеддинга, а не ответ в диалоге или переписанный документ.

У этой конкретной версии длина последовательности составляет 32K токенов, а размерность эмбеддинга — до 2 560. Она поддерживает выбор выходной размерности от 32 до 2 560 с помощью Matryoshka Representation Learning. Выбранная длина вектора влияет на хранение и сравнение представления, поэтому используйте одинаковую размерность векторов запросов и документов в одной коллекции. У Qwen3-Embedding-8B другой размер модели и максимальная размерность 4 096; ни этот размер выходного вектора, ни идентичность модели 8B не переносятся на версию 4B. Существующий индекс должен сохранять собственные согласованные настройки представления.

Производитель описывает поддержку более 100 языков, включая языки программирования, с многоязычным и межъязыковым поиском и поиском по коду. Например, поиск по справочному центру может сопоставить вопрос пользователя с фрагментами на нескольких языках, а затем вернуть исходные фрагменты, соответствующие теме. Поиск по коду может сопоставить описание на естественном языке с нужными функциями и их документацией. При подготовке текста сохраняйте значимые заголовки, предметные термины и идентификаторы, а каждый представляемый фрагмент связывайте с его источником, чтобы приложение могло показать соответствующий материал.

Qwen3-Embedding-4B учитывает инструкции. Qwen рекомендует снабжать каждый запрос описанием задачи в одно предложение, адаптированным к нужной связи при поиске, а для многоязычных сценариев рекомендует инструкции на английском. Прямой пример помещает Instruct: перед описанием задачи и Query: перед текстом запроса. Документы для поиска в нём кодируются без этой инструкции для запроса. Практическая оригинальная инструкция может задавать поиск фрагментов документации, объясняющих указанную ошибку, или фрагментов исходного кода, реализующих описанное поведение. Это направляет представление на вопрос приложения, а не просит модель написать ответ.

Официальные примеры кодируют тексты запросов и документов, сравнивают их эмбеддинги с помощью косинусного сходства и демонстрируют пулинг скрытого состояния последнего токена с последующей нормализацией. В этом низкоуровневом примере вход обрезается на выбранном значении 8 192 токена; документированная длина последовательности модели остаётся 32K. Для длинного материала определите, какие фрагменты нужно представить, и убедитесь, что обрезка не удаляет незаметно часть, необходимую для запроса. Храните векторы со стабильными ссылками на источники, сравнивайте подготовленный запрос с коллекцией и возвращайте связанные фрагменты в порядке сходства.

Модель эмбеддингов Qwen использует подход с двойным энкодером, тогда как отдельные модели переранжирования используют кросс-энкодер для оценки пар «запрос–документ». В описании релиза эти модули используются совместно: эмбеддинги находят первоначальных кандидатов, а реранкер затем может уточнить их порядок. Сама Qwen3-Embedding-4B предоставляет представление отдельного текста. Её вектор — не оценка реранкера, не проверенное утверждение и не сгенерированный ответ. Если итоговый процесс отвечает на вопросы по найденному материалу, выбранные фрагменты источников остаются доказательной основой, передаваемой на следующий этап.

Ailoot Ultra · Эмбеддинги POST /v1/embeddings qwen/qwen3-embedding-4b

qwen/qwen3-embedding-4b

Alibaba /qwen/qwen3-embedding-4b

Начало

Qwen3-Embedding-4B представляет текст в виде семантических векторов для многоязычного поиска, поиска по коду, классификации и кластеризации. Эта модель 4B поддерживает последовательности длиной 32K токенов и выбор размерности вектора от 32 до 2 560.

Допустимые входные данные
Текст · token_ids
Результаты
embedding

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Эмбеддинги POST /v1/embeddings
Входные данные
text, token_ids
Результат
embedding
Выходной формат
json
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
qwen/qwen3-embedding-4b
По умолчанию—
ПолеinputТипstring|string[]|integer[]|integer[][]ТребованиеОбязательноЗначения и ограничения
Минимум элементов: 1
Условия: Непустой однородный пакет. ID токенов — неотрицательные целые числа.
Входной бюджет: Максимум: 32 768 · Текстовая единица: байты UTF8 · Единица токенов: элементы массива токенов
По умолчанию—
Полеencoding_formatТипstringТребованиеНеобязательноЗначения и ограничения
float
По умолчаниюfloat
ПолеdimensionsТипintegerТребованиеНе поддерживаетсяЗначения и ограничения
Минимум: 1
По умолчанию—
ПолеuserТипjson_valueТребованиеНеобязательноЗначения и ограничения
Условия: Source допускает это поле метаданных JSON; точная семантика у исходного поставщика зависит от модели.
По умолчанию—
Полеsession_idТипjson_valueТребованиеНеобязательноЗначения и ограничения
Условия: Source допускает это поле метаданных JSON; точная семантика у исходного поставщика зависит от модели.
По умолчанию—
ПолеtraceТипjson_valueТребованиеНеобязательноЗначения и ограничения
Условия: Source допускает это поле метаданных JSON; точная семантика у исходного поставщика зависит от модели.
По умолчанию—
ПолеproviderТипobjectТребованиеНеобязательноЗначения и ограничения
Условия: provider.options отклоняется
По умолчанию—
Сочетания входных материалов

text_to_embedding

Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, input
Параметрinput_shapesКонтрактstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
Параметрencoding_formatКонтрактfloat
Параметрdimensions_overrideКонтрактfalse
Параметрmax_input_budget_unitsКонтракт32768
Параметрmultimodal_objectsКонтрактfalse
Параметрmaterial_typesКонтрактtext, token_ids

Жизненный цикл: synchronous_json

Сохраняйте индекс и размерность каждого вектора.

Название мультимодальной модели не означает допуск объектов изображений на этом конкретном маршруте.

Тарифы

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим
Не указано При выборе быстрого режима
Режим flex
Не указано При выборе режима flex
Максимальная интенсивность рассуждений
Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Ставки Ailoot

Цены по конфигурациям

КонфигурацияШкала ставокПлата
КонфигурацияБазовые ставки за токеныШкала ставокБазовая ставкаПлата
Вход · Входные токены $0.00004 / 1K токенов
Выход · Выходные токены $0 / 1K токенов
Вход · Чтение кэша — / 1K токенов
Вход · Запись в кэш — / 1K токенов
Вход · Запись в кэш, 1 час — / 1K токенов

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Эмбеддинги

curlPython SDK
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "qwen/qwen3-embedding-4b", "input": ["First document", "Second document"]}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os

client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='qwen/qwen3-embedding-4b',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)

Получить и сохранить результаты

Ailoot Ultra · Эмбеддинги

json

Сохраняйте все готовые результаты

Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.

Сохраняйте каждый вектор с его индексом. Число векторов должно совпадать с числом входных элементов; размерности должны быть согласованы.

Если нужно проверить исходный ответ

Отдельный эндпоинт заданий эмбеддингов не вводится.

Поля ответа
ПолеТип
ПолеobjectТипstring
ПолеmodelТипstring
Полеdata[].indexТипinteger
Полеdata[].embeddingТипfinite float[]
ПолеusageТипobject
Ошибки и дальнейшие шаги
ОтветУсловиеСледующий шаг
Ответ400 · invalid_request_errorУсловиеНеверные обязательные поля, представление материалов или значение параметраСледующий шагИсправьте указанные поля перед новым запросом на создание.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra qwen/qwen3-embedding-4b

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

qwen/qwen3-embedding-4b

FAQ · Qwen: Qwen3 Embedding 4B
Какие входные данные и результаты доступны?

POST /v1/embeddings · qwen/qwen3-embedding-4b: text, token_ids → embedding

Какие поля использует запрос?

POST /v1/embeddings · qwen/qwen3-embedding-4b: model, input, encoding_format, provider

Какие ограничения действуют?

POST /v1/embeddings · qwen/qwen3-embedding-4b: input.budget.maximum: 32768 (байты UTF8); input.min_items: 1

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

Коммерческое приложение
Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса.
Лицензия для реселлера
Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи.
Документы на сайте
Оферта, лицензионный договор и политика обработки данных доступны до подключения.

Запросить реселлерскую лицензию · Оферта и лицензионный договор