Поделиться через


Fine Tuning - List

Возвращает список всех точно настроенных заданий, принадлежащих ресурсу Azure OpenAI. Сведения, возвращаемые для каждого задания точной настройки, содержат помимо идентификатора базовую модель, файлы обучения и проверки, гиперпараметры, метки времени, состояние и события. События создаются при изменении состояния задания, например при выполнении или завершении, а также при отправке результатов.

GET {endpoint}/openai/fine_tuning/jobs?api-version=2024-05-01-preview
GET {endpoint}/openai/fine_tuning/jobs?after={after}&limit={limit}&api-version=2024-05-01-preview

Параметры URI

Имя В Обязательно Тип Описание
endpoint
path True

string

url

Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например: https://aoairesource.openai.azure.com. Замените aoairesource именем учетной записи Azure OpenAI.

api-version
query True

string

Запрошенная версия API.

after
query

string

Идентификатор последнего события из предыдущего запроса на разбиение на страницы.

limit
query

integer

int32

Количество извлекаемых событий. По умолчанию — 20.

Заголовок запроса

Имя Обязательно Тип Описание
api-key True

string

Укажите ключ учетной записи Azure OpenAI для Cognitive Services.

Ответы

Имя Тип Описание
200 OK

FineTuningJobList

Успешное завершение

Other Status Codes

ErrorResponse

Произошла ошибка.

Безопасность

api-key

Укажите ключ учетной записи Cognitive Services Azure OpenAI здесь.

Тип: apiKey
В: header

Примеры

Getting all fine tuning jobs owned by this account.

Образец запроса

GET https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2024-05-01-preview

Пример ответа

{
  "has_more": false,
  "data": [
    {
      "hyperparameters": {
        "n_epochs": -1
      },
      "status": "succeeded",
      "model": "curie",
      "fine_tuned_model": "curie.ft-72a2792ef7d24ba7b82c7fe4a37e379f",
      "training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
      "result_files": [
        "file-181a1cbdcdcf4677ada87f63a0928099"
      ],
      "finished_at": 1646127311,
      "trained_tokens": 2342,
      "id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
      "created_at": 1646126127,
      "object": "fine_tuning.job"
    }
  ],
  "object": "list"
}

Определения

Имя Описание
Error

Ошибка

ErrorCode

ErrorCode

ErrorResponse

ErrorResponse

FineTuningHyperParameters

FineTuningHyperParameters

FineTuningJob

FineTuningJob

FineTuningJobList

FineTuningJobList

FineTuningState

FineTuningState

InnerError

InnerError

InnerErrorCode

InnerErrorCode

TypeDiscriminator

TypeDiscriminator

Error

Ошибка

Имя Тип Описание
code

ErrorCode

ErrorCode
Коды ошибок, определенные в рекомендациях Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

details

Error[]

Сведения об ошибке, если они доступны.

innererror

InnerError

InnerError
Внутренняя ошибка, определенная в рекомендациях Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

message

string

Сообщение об этой ошибке.

target

string

Расположение, в котором произошла ошибка , если доступно.

ErrorCode

ErrorCode

Имя Тип Описание
conflict

string

Запрошенная операция конфликтует с текущим состоянием ресурса.

contentFilter

string

Сбой создания образа из-за нашей системы безопасности.

fileImportFailed

string

Сбой импорта файла.

forbidden

string

Операция запрещена для текущего ключа пользователя или API.

internalFailure

string

Внутренняя ошибка. Повторите попытку.

invalidPayload

string

Данные запроса недопустимы для этой операции.

itemDoesAlreadyExist

string

Элемент уже существует.

jsonlValidationFailed

string

Сбой проверки данных jsonl.

notFound

string

Ресурс не найден.

quotaExceeded

string

Превышена квота.

serviceUnavailable

string

В настоящее время служба недоступна.

tooManyRequests

string

Слишком много запросов. Повторите попытку позже.

unauthorized

string

Текущий ключ пользователя или API не авторизован для операции.

unexpectedEntityState

string

Операция не может быть выполнена в состоянии текущего ресурса.

ErrorResponse

ErrorResponse

Имя Тип Описание
error

Error

Ошибка
Содержимое ошибки, как определено в рекомендациях Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

FineTuningHyperParameters

Имя Тип Описание
batch_size

integer

Размер пакета, используемый для обучения. Размер пакета — это количество обучающих примеров, используемых для обучения одного прямого и обратного прохода. Как правило, большие размеры пакетов работают лучше для больших наборов данных. Значение по умолчанию, а также максимальное значение для этого свойства относятся к базовой модели.

learning_rate_multiplier

number

Множитель скорости обучения, используемый для обучения. Скорость обучения точной настройки — это исходная скорость обучения, используемая для предварительного обучения, умноженная на данное значение. Большие темпы обучения, как правило, работают лучше при больших размерах пакетов. Мы рекомендуем поэкспериментировать со значениями в диапазоне от 0,02 до 0,2, чтобы проверить, что даст наилучшие результаты.

n_epochs

integer

Количество эпох для обучения модели. Под эпохой понимается один полный цикл набора данных для обучения.

FineTuningJob

FineTuningJob

Имя Тип Описание
created_at

integer

Метка времени создания этого задания или элемента (в эпохах Unix).

fine_tuned_model

string

Идентификатор (model-id) результирующей точно настроенной модели. Это свойство заполняется только для успешно завершенных запусков точной настройки. Используйте этот идентификатор для создания развертывания для вывода.

finished_at

integer

Метка времени успешного завершения этого задания или элемента (в эпохах Unix).

hyperparameters

FineTuningHyperParameters

FineTuningHyperParameters
Параметры гиперпараметров, используемые в задании точной настройки.

id

string

Удостоверение этого элемента.

model

string

Идентификатор (model-id) базовой модели, используемой для точной настройки.

object

TypeDiscriminator

TypeDiscriminator
Определяет тип объекта .

organisation_id

string

Идентификатор организации этой тонкой настройки работы. Неиспользуется в Azure OpenAI; совместимость только для OpenAI.

result_files

string[]

Идентификаторы результирующих файлов (file-id), содержащие метрики обучения и оценки в формате CSV. Файл доступен только для успешно завершенных запусков точной настройки.

seed

integer

Начальное значение, используемое для задания тонкой настройки.

status

FineTuningState

FineTuningState
Состояние объекта finetunes или задания тонкой настройки.

suffix

string

Суффикс, используемый для идентификации точно настроенной модели. Суффикс может содержать до 40 символов (a–z, A–Z, 0–9 и _), которые будут добавлены к точно настроенной модели.

trained_tokens

integer

Общее количество оплачиваемых маркеров, обработанных этим заданием тонкой настройки.

training_file

string

Файл, используемый для обучения.

validation_file

string

Файл, который используется для оценки точно настроенной модели во время обучения.

FineTuningJobList

FineTuningJobList

Имя Тип Описание
data

FineTuningJob[]

Список элементов.

has_more

boolean

Значение , указывающее, содержит ли список больше элементов, чем возвращено.

object

TypeDiscriminator

TypeDiscriminator
Определяет тип объекта .

FineTuningState

FineTuningState

Имя Тип Описание
cancelled

string

Операция отменена и не завершена. Его можно классифицировать как конечное состояние.

created

string

Операция создана. Azure OpenAI не возвращает это состояние и предоставляется только для обеспечения совместимости. Его можно классифицировать как неактивное состояние.

failed

string

Операция завершила обработку с ошибкой и не может быть использована в дальнейшем. Его можно классифицировать как конечное состояние.

pending

string

Операция еще не поставлена в очередь для обработки в будущем. Его можно классифицировать как неактивное состояние.

running

string

Операция запущена для обработки. Его можно классифицировать как активное состояние.

succeeded

string

Операция успешно обработана и готова к использованию. Его можно классифицировать как конечное состояние.

InnerError

InnerError

Имя Тип Описание
code

InnerErrorCode

InnerErrorCode
Внутренние коды ошибок, определенные в рекомендациях Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

innererror

InnerError

InnerError
Внутренняя ошибка, определенная в рекомендациях Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

InnerErrorCode

Имя Тип Описание
invalidPayload

string

Данные запроса недопустимы для этой операции.

TypeDiscriminator

TypeDiscriminator

Имя Тип Описание
file

string

Этот объект представляет файл.

fine_tuning.job

string

Этот объект представляет задание точной настройки.

fine_tuning.job.checkpoint

string

Этот объект представляет контрольную точку задания тонкой настройки.

fine_tuning.job.event

string

Этот объект представляет событие задания тонкой настройки.

list

string

Этот объект представляет список других объектов.

model

string

Этот объект представляет модель (может быть базовой моделью или результатом точной настройки задания).