Fine Tuning - Create

Başvuru

Hizmet:: Azure AI Services

API Sürümü:: 2023-12-01-preview

Belirli bir eğitim dosyasından belirli bir modeli ince ayarlayan bir iş oluşturur. Yanıt, iş durumu ve hiper parametreler de dahil olmak üzere sıraya alınan işin ayrıntılarını içerir. İnce ayarlı modelin adı tamamlandıktan sonra yanıta eklenir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string url	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://aoairesource.openai.azure.com. "aoairesource" yerine Azure OpenAI hesap adınızı yazın).
api-version	query	True	string	İstenen API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
api-key	True	string	Bilişsel Hizmetler Azure OpenAI hesap anahtarınızı burada sağlayın.

İstek Gövdesi

Name	Gerekli	Tür	Description
model	True	string	Bu ince ayar için kullanılan temel modelin tanımlayıcısı (model-kimliği).
training_file	True	string	Bu ince ayarlı modelin eğitimi için kullanılan dosya kimliği (dosya kimliği).
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters İnce ayar işinde kullanılan hiper parametre ayarları.
suffix		string	İnce ayarlı modeli tanımlamak için kullanılan sonek. Sonek, ince ayarlı model adınıza eklenecek en fazla 40 karakter (a-z, A-Z, 0-9,- ve _) içerebilir.
validation_file		string	Eğitim sırasında ince ayarlı modeli değerlendirmek için kullanılan dosya kimliği (file-id).

Yanıtlar

Name	Tür	Description
201 Created	FineTuningJob	İnce ayar başarıyla oluşturuldu. Üst Bilgiler Location: string
Other Status Codes	ErrorResponse	Bir hata oluşmuştur.

Name

Tür

Description

201 Created

FineTuningJob

İnce ayar başarıyla oluşturuldu.

Üst Bilgiler

Location: string

Other Status Codes

ErrorResponse

Bir hata oluşmuştur.

Güvenlik

api-key

Bilişsel Hizmetler Azure OpenAI hesap anahtarınızı burada sağlayın.

Tür: apiKey
İçinde: header

Örnekler

Creating a fine tune job.

Örnek isteği

HTTP

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


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

Örnek yanıt

Durum kodu:: 201

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

{
  "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"
}

Tanımlar

Name	Description
Error	Hata
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Hata

Name	Tür	Description
code	ErrorCode	ErrorCode Microsoft REST yönergelerinde (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses ) tanımlandığı gibi hata kodları.
details	Error[]	Varsa hata ayrıntıları.
innererror	InnerError	InnerError Microsoft REST yönergelerinde (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses tanımlandığı gibi iç hata.
message	string	Bu hatanın iletisi.
target	string	Varsa hatanın oluştuğu konum.

ErrorCode

Name	Tür	Description
conflict	string	İstenen işlem geçerli kaynak durumuyla çakişer.
contentFilter	string	Güvenlik sistemimiz sonucunda görüntü oluşturma başarısız oldu.
fileImportFailed	string	Dosya içeri aktarılamadı.
forbidden	string	Geçerli kullanıcı/api anahtarı için işlem yasaktır.
internalFailure	string	İç hata. Lütfen yeniden deneyin.
invalidPayload	string	İstek verileri bu işlem için geçersiz.
itemDoesAlreadyExist	string	Öğe zaten var.
jsonlValidationFailed	string	Jsonl verileri doğrulanamadı.
notFound	string	Kaynak bulunamadı.
quotaExceeded	string	Kota aşıldı.
serviceUnavailable	string	Hizmet şu anda kullanılamıyor.
tooManyRequests	string	Çok fazla istek var. Daha sonra yeniden deneyin.
unauthorized	string	Geçerli kullanıcı/api anahtarı işlem için yetkilendirilmedi.
unexpectedEntityState	string	İşlem geçerli kaynağın durumunda yürütülemez.

ErrorResponse

Name	Tür	Description
error	Error	Hata Microsoft REST yönergelerinde (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses ) tanımlandığı gibi hata içeriği.

FineTuningHyperParameters

Name	Tür	Description
batch_size	integer	Eğitim için kullanılacak toplu iş boyutu. Toplu iş boyutu, tek bir ileri ve geri geçişi eğitmek için kullanılan eğitim örneklerinin sayısıdır. Genel olarak, daha büyük toplu iş boyutlarının büyük veri kümeleri için daha iyi çalışma eğiliminde olduğunu bulduk. Bu özelliğin varsayılan değeri ve en büyük değeri bir temel modele özeldir.
learning_rate_multiplier	number	Eğitim için kullanılacak öğrenme hızı çarpanı. İnce ayar öğrenme oranı, eğitim öncesi eğitim için kullanılan özgün öğrenme oranının bu değerle çarpılmasıdır. Daha büyük öğrenme hızları, daha büyük toplu iş boyutlarıyla daha iyi performans gösterme eğilimindedir. En iyi sonuçları neyin ürettiğini görmek için 0,02 ile 0,2 aralığındaki değerlerle denemeler yapmanızı öneririz.
n_epochs	integer	Modeli eğitmek için dönem sayısı. Dönem, eğitim veri kümesinde bir tam döngü anlamına gelir.

FineTuningJob

Name	Tür	Description
created_at	integer	Bu işin veya öğenin oluşturulduğu zaman damgası (unix dönemlerinde).
fine_tuned_model	string	Sonuçta elde edilen ince ayarlı modelin tanımlayıcısı (model-id). Bu özellik yalnızca başarıyla tamamlanan ince ayar çalıştırmaları için doldurulur. Çıkarım için bir dağıtım oluşturmak için bu tanımlayıcıyı kullanın.
finished_at	integer	Bu iş veya öğe başarıyla tamamlandığında bir zaman damgası (unix dönemlerinde).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters İnce ayar işinde kullanılan hiper parametre ayarları.
id	string	Bu öğenin kimliği.
model	string	İnce ayar için kullanılan temel modelin tanımlayıcısı (model-kimliği).
object	TypeDiscriminator	TypeDiscriminator Nesnenin türünü tanımlar.
organisation_id	string	Bu ince ayar işinin kuruluş kimliği. Azure OpenAI'de kullanılmadı; yalnızca OpenAI için uyumluluk.
result_files	string[]	Csv biçiminde eğitim ve değerlendirme ölçümlerini içeren sonuç dosya kimlikleri (dosya kimliği). Dosya yalnızca başarıyla tamamlanan ince ayar çalıştırmaları için kullanılabilir.
status	FineTuningState	FineTuningState İnce ayar nesnesinin veya ince ayar işinin durumu.
suffix	string	İnce ayarlı modeli tanımlamak için kullanılan sonek. Son ek, ince ayarlı model adınıza eklenecek en fazla 40 karakter (a-z, A-Z, 0-9,- ve _) içerebilir.
trained_tokens	integer	Bu ince ayarlama işi tarafından işlenen faturalanabilir belirteçlerin toplam sayısı.
training_file	string	Eğitim için kullanılan dosya.
updated_at	integer	Bu işin veya öğenin en son değiştirildiği zaman damgası (unix dönemlerinde).
validation_file	string	Eğitim sırasında ince ayarlı modeli değerlendirmek için kullanılan dosya.

FineTuningJobCreation

Name	Tür	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters İnce ayar işinde kullanılan hiper parametre ayarları.
model	string	Bu ince ayar için kullanılan temel modelin tanımlayıcısı (model-kimliği).
suffix	string	İnce ayarlı modeli tanımlamak için kullanılan sonek. Son ek, ince ayarlı model adınıza eklenecek en fazla 40 karakter (a-z, A-Z, 0-9,- ve _) içerebilir.
training_file	string	Bu ince ayarlı modelin eğitimi için kullanılan dosya kimliği (dosya kimliği).
validation_file	string	Eğitim sırasında ince ayarlı modeli değerlendirmek için kullanılan dosya kimliği (file-id).

FineTuningState

Name	Tür	Description
cancelled	string	İşlem iptal edildi ve tamamlanmadı. Terminal durumu olarak kategorilere ayrılabilir.
created	string	İşlem oluşturuldu. Bu durum Azure OpenAI tarafından döndürülmedi ve yalnızca uyumluluk için kullanıma sunuldu. Etkin olmayan bir durum olarak kategorilere ayrılabilir.
failed	string	İşlem bir hatayla işlemeyi tamamladı ve daha fazla kullanılamaz. Terminal durumu olarak kategorilere ayrılabilir.
pending	string	İşlem henüz gelecekte işlenmek üzere kuyruğa alınmadı. Etkin olmayan bir durum olarak kategorilere ayrılabilir.
running	string	İşlem işlenmeye başlandı. Etkin durum olarak kategorilere ayrılabilir.
succeeded	string	İşlem başarıyla işlendi ve kullanıma hazır. Terminal durumu olarak kategorilere ayrılabilir.

InnerError

Name	Tür	Description
code	InnerErrorCode	InnerErrorCode Microsoft REST yönergelerinde (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses ) tanımlanan iç hata kodları.
innererror	InnerError	InnerError Microsoft REST yönergelerinde (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses tanımlandığı gibi iç hata.

InnerErrorCode

Name	Tür	Description
invalidPayload	string	İstek verileri bu işlem için geçersiz.

TypeDiscriminator

Name	Tür	Description
file	string	Bu nesne bir dosyayı temsil eder.
fine-tune	string	Bu nesne ince ayar işini temsil eder.
fine-tune-event	string	Bu nesne, ince ayar işinin olayını temsil eder.
fine_tuning.job	string	Bu nesne ince ayar işini temsil eder.
fine_tuning.job.event	string	Bu nesne, ince ayar işinin olayını temsil eder.
list	string	Bu nesne, diğer nesnelerin listesini temsil eder.
model	string	Bu nesne bir modeli temsil eder (temel model veya ince ayar iş sonucu olabilir).

Aracılığıyla paylaş

Fine Tuning - Create

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Güvenlik

api-key

Örnekler

Creating a fine tune job.

Örnek isteği

Örnek yanıt

Tanımlar

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Ek kaynaklar