Voyage AI: Voyage Code 3
Voyage Code 3 создаёт эмбеддинги для поиска кода по тексту, коду и строкам документации. Окно 32 000 токенов, выбор размерности векторов и квантованный вывод поддерживают поиск по репозиторию и выбор кодового контекста для помощников по программированию.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Voyage Code 3 — модель эмбеддингов, специализированная на поиске исходного кода. Производитель описывает поиск кода по естественному языку, коду и строкам документации: вопрос может найти реализацию, фрагмент кода — связанную логику, а описание функции — соответствующий код. Модель создаёт векторы для поиска, а не отредактированный файл или готовую программу.
Подготавливайте материалы репозитория вокруг осмысленных единиц кода. Сохраняйте функцию вместе с именем, сигнатурой и комментариями о её назначении. Для более крупного компонента включайте соседние определения, необходимые для понимания операции. Храните репозиторий, версию, путь файла и положение строки отдельно, чтобы результат поиска открывал точный источник, для которого создан эмбеддинг.
Поиск на естественном языке может описывать поведение, например найти часть проекта, проверяющую загрузку до сохранения. Запрос кодом может предоставлять функцию, аналогичное назначение которой нужно найти в другом месте. Выбирайте характерные запросы из реальных задач разработки, включая незнакомые имена, похожие реализации и утилиты, смысл которых зависит от окружающего кода.
Контекстное окно 32 000 токенов вмещает значительные фрагменты кода. Используйте этот объём осознанно: полная функция с нужными зависимостями может быть информативнее произвольного блока, обрезанного посередине потока управления. Сохраняйте читаемое форматирование и синтаксис языка при извлечении. Если исходный файл больше входного окна, разделяйте его по полезным структурным границам и сохраняйте связь фрагментов с родительским файлом.
Voyage Code 3 поддерживает эмбеддинги размерностью 2 048, 1 024, 512 или 256, а также представления с плавающей точкой, знаковые или беззнаковые восьмибитные и двоичные представления. Эти параметры поддерживают разные размеры индекса репозитория и конфигурации поиска. Проверяйте компактное представление теми же реальными запросами, что и более крупный исходный вариант, оценивая сохранение нужной функции или файла среди полезных результатов.
Для помощника по программированию сначала найдите соответствующие фрагменты источника, затем передайте их вместе со ссылками на файлы компоненту, отвечающему за ответ или внесение изменений. Совпадение по сходству помогает выбрать контекст, но не доказывает взаимозаменяемость двух реализаций. Проверяйте входные данные, побочные эффекты и окружающие контракты найденного кода до его использования для правки.
Отделяйте не связанные между собой версии репозитория через метаданные и сохраняйте прослеживаемость индексируемых версий. При перемещении функции или изменении её поведения обновляйте и вектор, и положение в источнике. Одинаковые настройки эмбеддингов должны описывать индексируемый источник и его запросы. При миграции индекса сравнивайте результаты по существующему набору вопросов, чтобы изменённая модель или представление вектора незаметно не меняли код, показываемый разработчику.
Полезные проверки: находит ли запрос фактическую реализацию, а не только название теста; находит ли строка документации свою функцию; отличается ли семантически связанный код от внешне похожего фрагмента. Сохраняйте возвращённый исходный текст и его положение в результате поиска, чтобы разработчики могли проверить данные. Так специализированные эмбеддинги кода превращаются в практический инструмент навигации и выбора контекста.
Ailoot Ultra · Эмбеддинги POST /v1/embeddings voyage-code-3
voyage-code-3Начало
Voyage Code 3 создаёт эмбеддинги для поиска кода по тексту, коду и строкам документации. Окно 32 000 токенов, выбор размерности векторов и квантованный вывод поддерживают поиск по репозиторию и выбор кодового контекста для помощников по программированию.
- Допустимые входные данные
- Текст
- Результаты
- embedding
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Эмбеддинги POST /v1/embeddings
- Входные данные
text- Результат
embedding
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения voyage-code-3 Условия: Используйте точный идентификатор модели Ailoot. | По умолчанию— |
Полеinput | Типstring or array<string> | ТребованиеОбязательно | Значения и ограничения Условия: Текст или список текстов; сохраняйте по одному вектору для каждого возвращённого элемента data вместе с его индексом. | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, input |
Параметрoptional | Контракт |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактПередайте текст с выбранной моделью; сохраняйте каждый возвращённый вектор и его индекс. |
Жизненный цикл: synchronous
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
| Конфигурация | Шкала ставок | Плата |
|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Плата Вход · Входные токены $0.0004 / 1K токенов Выход · Выходные токены $0 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Эмбеддинги
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "voyage-code-3",
"input": "The quick brown fox jumps over the lazy dog"
}
JSON
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 embeddings.json
# Keep every data item and its index, the full usage object and response headers.
Получить и сохранить результаты
Псевдонимы
Псевдонимы моделей
Ailoot Ultra voyage-code-3
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Voyage AI: Voyage Code 3
- Какие входные данные и результаты доступны?
POST /v1/embeddings·voyage-code-3:text→embedding- Какие поля использует запрос?
POST /v1/embeddings·voyage-code-3:model,input