Fine Tuning - Create

참조

Service:: Azure AI Services

API Version:: 2023-12-01-preview

지정된 학습 파일에서 지정된 모델을 미세 조정하는 작업을 만듭니다. 응답에는 작업 상태 및 하이퍼 매개 변수를 포함하여 큐에 추가된 작업의 세부 정보가 포함됩니다. 미세 조정된 모델의 이름은 완료되면 응답에 추가됩니다.

POST {endpoint}/openai/fine_tuning/jobs?api-version=2023-12-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string url	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://aoairesource.openai.azure.com) "aoairesource"를 Azure OpenAI 계정 이름으로 대체합니다.)
api-version	query	True	string	요청된 API 버전입니다.

요청 헤더

Name	필수	형식	Description
api-key	True	string	여기에서 Cognitive Services Azure OpenAI 계정 키를 제공합니다.

요청 본문

Name	필수	형식	Description
model	True	string	이 미세 조정에 사용되는 기본 모델의 식별자(model-id)입니다.
training_file	True	string	이 미세 조정된 모델을 학습하는 데 사용되는 파일 ID(파일 ID)입니다.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters 미세 조정 작업에 사용되는 하이퍼 매개 변수 설정입니다.
suffix		string	미세 조정된 모델을 식별하는 데 사용되는 접미사입니다. 접미사는 미세 조정된 모델 이름에 추가될 최대 40자(a-z, A-Z, 0-9, 및 _)를 포함할 수 있습니다.
validation_file		string	학습 중에 미세 조정된 모델을 평가하는 데 사용되는 파일 ID(파일 ID)입니다.

응답

Name	형식	Description
201 Created	FineTuningJob	미세 조정이 성공적으로 만들어졌습니다. Headers Location: string
Other Status Codes	ErrorResponse	오류가 발생했습니다.

Name

형식

Description

201 Created

FineTuningJob

미세 조정이 성공적으로 만들어졌습니다.

Headers

Location: string

Other Status Codes

ErrorResponse

오류가 발생했습니다.

보안

api-key

여기에서 Cognitive Services Azure OpenAI 계정 키를 제공합니다.

Type: apiKey
In: header

예제

Creating a fine tune job.

Sample Request

HTTP

POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2023-12-01-preview


{
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}

Sample Response

Status code:: 201

location: https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f

Response Body

{
  "hyperparameters": {
    "n_epochs": 2
  },
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
  "id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
  "status": "notRunning",
  "created_at": 1646126127,
  "updated_at": 1646127311,
  "object": "fine_tuning.job"
}

정의

Name	Description
Error	오류
ErrorCode	오류 코드
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

오류

Name	형식	Description
code	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

오류 코드

Name	형식	Description
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

Name	형식	Description
error	Error	오류 Microsoft REST 지침(https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses)에 정의된 오류 콘텐츠입니다.

FineTuningHyperParameters

Name	형식	Description
batch_size	integer	학습에 사용할 일괄 처리 크기입니다. 일괄 처리 크기는 단일 전진 및 후진 계산법을 학습하는 데 사용되는 학습 예의 수입니다. 일반적으로 일괄 처리 크기가 클수록 데이터 세트가 클수록 더 잘 작동하는 경향이 있습니다. 기본값과 이 속성의 최대값은 기본 모델과 관련이 있습니다.
learning_rate_multiplier	number	학습에 사용할 학습 속도 승수입니다. 미세 조정 학습 속도는 사전 학습에 사용된 원래 학습 속도에 이 값을 곱한 값입니다. 더 큰 학습 속도는 더 큰 일괄 처리 크기로 더 나은 성능을 발휘하는 경향이 있습니다. 0.02에서 0.2 사이의 값으로 실험하여 최상의 결과를 생성하는 값을 확인하는 것이 좋습니다.
n_epochs	integer	모델을 학습할 Epoch의 수입니다. Epoch는 학습 데이터 세트를 통한 하나의 전체 주기를 나타냅니다.

FineTuningJob

Name	형식	Description
created_at	integer	이 작업 또는 항목이 만들어졌을 때의 타임스탬프입니다(unix epoch).
fine_tuned_model	string	결과 미세 조정된 모델의 식별자(model-id)입니다. 이 속성은 성공적으로 완료된 미세 조정 실행에 대해서만 채워집니다. 이 식별자를 사용하여 추론을 위한 배포를 만듭니다.
finished_at	integer	이 작업 또는 항목이 성공적으로 완료된 타임스탬프입니다(unix epoch).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters 미세 조정 작업에 사용되는 하이퍼 매개 변수 설정입니다.
id	string	이 항목의 ID입니다.
model	string	미세 조정에 사용되는 기본 모델의 식별자(model-id)입니다.
object	TypeDiscriminator	TypeDiscriminator 개체의 형식을 정의합니다.
organisation_id	string	이 미세 조정 작업의 조직 ID입니다. Azure OpenAI에서 사용되지 않음; OpenAI에 대해서만 호환성.
result_files	string[]	csv 형식의 학습 및 평가 메트릭을 포함하는 결과 파일 ID(file-id)입니다. 파일은 성공적으로 완료된 미세 조정 실행에만 사용할 수 있습니다.
status	FineTuningState	FineTuningState 미세 조정 개체 또는 미세 조정 작업의 상태입니다.
suffix	string	미세 조정된 모델을 식별하는 데 사용되는 접미사입니다. 접미사는 미세 조정된 모델 이름에 추가될 최대 40자(a-z, A-Z, 0-9, 및 _)를 포함할 수 있습니다.
trained_tokens	integer	이 미세 조정 작업에서 처리한 청구 가능한 토큰의 총 수입니다.
training_file	string	학습에 사용되는 파일입니다.
updated_at	integer	이 작업 또는 항목이 마지막으로 수정된 타임스탬프(unix epoch)입니다.
validation_file	string	학습 중에 미세 조정된 모델을 평가하는 데 사용되는 파일입니다.

FineTuningJobCreation

Name	형식	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters 미세 조정 작업에 사용되는 하이퍼 매개 변수 설정입니다.
model	string	이 미세 조정에 사용되는 기본 모델의 식별자(model-id)입니다.
suffix	string	미세 조정된 모델을 식별하는 데 사용되는 접미사입니다. 접미사는 미세 조정된 모델 이름에 추가될 최대 40자(a-z, A-Z, 0-9, 및 _)를 포함할 수 있습니다.
training_file	string	이 미세 조정된 모델을 학습시키는 데 사용되는 파일 ID(file-id)입니다.
validation_file	string	학습 중에 미세 조정된 모델을 평가하는 데 사용되는 파일 ID(file-id)입니다.

FineTuningState

Name	형식	Description
cancelled	string	작업이 취소되었으며 불완전합니다. 터미널 상태로 분류할 수 있습니다.
created	string	작업이 만들어졌습니다. 이 상태는 Azure OpenAI에서 반환되지 않으며 호환성을 위해만 노출됩니다. 비활성 상태로 분류할 수 있습니다.
failed	string	작업이 실패로 처리를 완료했으며 더 이상 사용할 수 없습니다. 터미널 상태로 분류할 수 있습니다.
pending	string	작업은 나중에 처리될 큐에 대기되지 않습니다. 비활성 상태로 분류할 수 있습니다.
running	string	작업이 처리되기 시작했습니다. 활성 상태로 분류할 수 있습니다.
succeeded	string	작업이 성공적으로 처리되었으며 사용할 준비가 되었습니다. 터미널 상태로 분류할 수 있습니다.

InnerError

Name	형식	Description
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

Name	형식	Description
invalidPayload	string	이 작업에 대한 요청 데이터가 잘못되었습니다.

TypeDiscriminator

Name	형식	Description
file	string	이 개체는 파일을 나타냅니다.
fine-tune	string	이 개체는 미세 조정 작업을 나타냅니다.
fine-tune-event	string	이 개체는 미세 조정 작업의 이벤트를 나타냅니다.
fine_tuning.job	string	이 개체는 미세 조정 작업을 나타냅니다.
fine_tuning.job.event	string	이 개체는 미세 조정 작업의 이벤트를 나타냅니다.
list	string	이 개체는 다른 개체의 목록을 나타냅니다.
model	string	이 개체는 모델을 나타냅니다(기본 모델 또는 미세 조정 작업 결과일 수 있음).

다음을 통해 공유

Fine Tuning - Create

URI 매개 변수

요청 헤더

요청 본문

응답

보안

api-key

예제

Creating a fine tune job.

Sample Request

Sample Response

정의

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

추가 리소스