Fine Tunes - Create
Belirli bir eğitim dosyasından belirtilen modeli ince ayarlayan bir iş oluşturur. Yanıt, iş durumu ve hiper parametreler de dahil olmak üzere sıralanan işin ayrıntılarını içerir. İnce ayarlı modelin adı tamamlandıktan sonra yanıta eklenir.
POST {endpoint}/openai/fine-tunes?api-version=2023-05-15
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ı buradan sağlayın. |
İstek Gövdesi
| Name | Gerekli | Tür | Description |
|---|---|---|---|
| model | True |
string minLength: 1 |
Bu ince ayar için kullanılan temel modelin tanımlayıcısı (model-kimliği). |
| training_file | True |
string minLength: 1 |
Bu hassas ayarlı modelin eğitimi için kullanılan dosya kimliği (dosya kimliği). |
| batch_size |
integer (int32) |
Eğitim için kullanılacak toplu iş boyutu. Toplu iş boyutu, tek 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 daha 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. |
|
| classification_betas |
number[] (double) |
Sınıflandırma beta değerleri. Bu sağlanırsa, belirtilen beta değerlerinde F-beta puanlarını hesaplarız. F-beta puanı, F-1 puanının genelleştirilmesidir. Bu yalnızca ikili sınıflandırma için kullanılır. 1 beta (yani F-1 puanı) ile duyarlık ve yakalama aynı ağırlıkta verilir. Daha büyük bir beta puanı, geri çağırmaya daha fazla ağırlık ve daha az duyarlık getirir. Daha küçük bir beta puanı, duyarlık üzerinde daha fazla ağırlık ve geri çağırmaya daha az ağırlık getirir. |
|
| classification_n_classes |
integer (int32) |
Sınıflandırma görevindeki sınıfların sayısı. Bu parametre çok sınıflı sınıflandırma için gereklidir. |
|
| classification_positive_class |
string |
İkili sınıflandırmadaki pozitif sınıf. İkili sınıflandırma yapılırken duyarlık, geri çağırma ve F1 ölçümleri oluşturmak için bu parametre gereklidir. |
|
| compute_classification_metrics |
boolean |
Sınıflandırma ölçümlerinin hesaplanıp hesaplanmayacağını gösteren değer. Ayarlanırsa, her dönem sonundaki doğrulama kümesini kullanarak doğruluk ve F-1 puanı gibi sınıflandırmaya özgü ölçümleri hesaplarız. Bu ölçümler sonuçlar dosyasında görüntülenebilir. Sınıflandırma ölçümlerini hesaplamak için bir validation_file sağlamanız gerekir. Ayrıca, çok sınıflı sınıflandırma için classification_n_classes veya ikili sınıflandırma için classification_positive_class belirtmeniz gerekir. |
|
| learning_rate_multiplier |
number (double) |
Eğitim için kullanılacak öğrenme oranı çarpanı. İnce ayarlama öğrenme oranı, ön eğitim için kullanılan özgün öğrenme oranıdır ve bu değerle çarpılır. Daha büyük öğrenme oranları, 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 (int32) |
Modeli eğitmek için dönem sayısı. Dönem, eğitim veri kümesindeki bir tam döngüyü ifade eder. |
|
| prompt_loss_weight |
number (double) |
İstem belirteçlerinde kayıp için kullanılacak ağırlık. Bu, modelin istem oluşturmayı (her zaman ağırlığı 1,0 olan tamamlama ile karşılaştırıldığında) ne kadar öğrenmeye çalıştığını denetler ve tamamlamalar kısa olduğunda eğitime dengeleyici bir etki ekleyebilir. İstemler son derece uzunsa (tamamlanmalara göre), istemleri aşırı önceliklendirmemek için bu ağırlığı azaltmak mantıklı olabilir. |
|
| suffix |
string |
hassas 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 ayarlanmış modeli değerlendirmek için kullanılan dosya kimliği (file-id). |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 201 Created |
İnce ayar başarıyla oluşturuldu. Üst Bilgiler Location: string |
|
| Other Status Codes |
Bir hata oluştu. |
Güvenlik
api-key
Bilişsel Hizmetler Azure OpenAI hesap anahtarınızı buradan sağlayın.
Tür:
apiKey
İçinde:
header
Örnekler
| Creating a fine tune job for classification. |
| Creating a fine tune job. |
Creating a fine tune job for classification.
Örnek isteği
POST https://aoairesource.openai.azure.com/openai/fine-tunes?api-version=2023-05-15
{
"compute_classification_metrics": true,
"classification_n_classes": 4,
"model": "curie",
"training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}
Örnek yanıt
location: https://aoairesource.openai.azure.com/openai/fine-tunes/ft-72a2792ef7d24ba7b82c7fe4a37e379f
{
"hyperparams": {
"compute_classification_metrics": true,
"classification_n_classes": 4,
"batch_size": 32,
"learning_rate_multiplier": 1,
"n_epochs": 2,
"prompt_loss_weight": 0.1
},
"model": "curie",
"training_files": [
{
"statistics": {
"tokens": 42,
"examples": 23
},
"bytes": 140,
"purpose": "fine-tune",
"filename": "puppy.jsonl",
"id": "file-181a1cbdcdcf4677ada87f63a0928099",
"status": "succeeded",
"created_at": 1646126127,
"updated_at": 1646127311,
"object": "file"
}
],
"id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
"status": "notRunning",
"created_at": 1646126127,
"updated_at": 1646127311,
"object": "fine-tune"
}
Creating a fine tune job.
Örnek isteği
POST https://aoairesource.openai.azure.com/openai/fine-tunes?api-version=2023-05-15
{
"model": "curie",
"training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}
Örnek yanıt
location: https://aoairesource.openai.azure.com/openai/fine-tunes/ft-72a2792ef7d24ba7b82c7fe4a37e379f
{
"hyperparams": {
"batch_size": 32,
"learning_rate_multiplier": 1,
"n_epochs": 2,
"prompt_loss_weight": 0.1
},
"model": "curie",
"training_files": [
{
"statistics": {
"tokens": 42,
"examples": 23
},
"bytes": 140,
"purpose": "fine-tune",
"filename": "puppy.jsonl",
"id": "file-181a1cbdcdcf4677ada87f63a0928099",
"status": "succeeded",
"created_at": 1646126127,
"updated_at": 1646127311,
"object": "file"
}
],
"id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
"status": "notRunning",
"created_at": 1646126127,
"updated_at": 1646127311,
"object": "fine-tune"
}
Tanımlar
| Name | Description |
|---|---|
| Error |
Hata |
|
Error |
ErrorCode |
|
Error |
ErrorResponse |
| Event |
Olay |
| File |
Dosya |
|
File |
FileStatistics |
|
Fine |
FineTune |
|
Fine |
FineTuneCreation |
|
Hyper |
Hiper Parametreler |
|
Inner |
InnerError |
|
Inner |
InnerErrorCode |
|
Log |
LogLevel |
| Purpose |
Amaç |
| State |
Devlet |
|
Type |
TypeDiscriminator |
Error
Hata
| Name | Tür | Description |
|---|---|---|
| code |
ErrorCode |
|
| details |
Error[] |
Varsa hata ayrıntıları. |
| innererror |
InnerError |
|
| message |
string minLength: 1 |
Bu hatanın iletisi. |
| target |
string |
Varsa hatanın oluştuğu konum. |
ErrorCode
ErrorCode
| Değer | Description |
|---|---|
| conflict |
İstenen işlem geçerli kaynak durumuyla çakişer. |
| invalidPayload |
İstek verileri bu işlem için geçersiz. |
| forbidden |
geçerli kullanıcı/api anahtarı için işlem yasaktır. |
| notFound |
Kaynak bulunamadı. |
| unexpectedEntityState |
İşlem geçerli kaynağın durumunda yürütülemez. |
| itemDoesAlreadyExist |
Öğe zaten var. |
| serviceUnavailable |
Hizmet şu anda kullanılamıyor. |
| internalFailure |
İç hata. Lütfen yeniden deneyin. |
| quotaExceeded |
Kota aşıldı. |
| jsonlValidationFailed |
Jsonl verileri doğrulanamadı. |
| fileImportFailed |
Dosya içeri aktarılamadı. |
ErrorResponse
ErrorResponse
| Name | Tür | Description |
|---|---|---|
| error |
Hata |
Event
Olay
| Name | Tür | Description |
|---|---|---|
| created_at |
integer (unixtime) |
Bu olayın oluşturulduğu zaman damgası (unix dönemlerinde). |
| level |
LogLevel |
|
| message |
string minLength: 1 |
Olayı açıklayan ileti. Bu durum değişikliği (ör. sıralanmış, başlatılmış, başarısız veya tamamlanmış) veya karşıya yüklenen sonuçlar gibi diğer olaylar olabilir. |
| object |
TypeDiscriminator |
File
Dosya
| Name | Tür | Description |
|---|---|---|
| bytes |
integer (int64) |
Kullanılabilir olduğunda bu dosyanın boyutu (null olabilir). JavaScript tamsayılarıyla uyumluluğu sağlamak için 2^53-1'den büyük dosya boyutları desteklenmez. |
| created_at |
integer (unixtime) |
Bu işin veya öğenin oluşturulduğu zaman damgası (unix dönemlerinde). |
| error |
Hata |
|
| filename |
string minLength: 1 |
Dosyanın adı. |
| id |
string |
Bu öğenin kimliği. |
| object |
TypeDiscriminator |
|
| purpose |
Amaç |
|
| statistics |
FileStatistics |
|
| status |
Devlet |
|
| updated_at |
integer (unixtime) |
Bu işin veya öğenin en son değiştirildiği zaman damgası (unix dönemlerinde). |
FileStatistics
FileStatistics
| Name | Tür | Description |
|---|---|---|
| examples |
integer (int32) |
Dosya içeriğinin doğrulanması tamamlandıktan sonra dosyalarda yer alan eğitim örneklerinin sayısı "ince ayar" türündedir. |
| tokens |
integer (int32) |
Dosya içeriğini doğrulama tamamlandıktan sonra istemlerde kullanılan belirteçlerin sayısı ve "ince ayar" türündeki dosyalar için tamamlamalar. |
FineTune
FineTune
| Name | Tür | Description |
|---|---|---|
| created_at |
integer (unixtime) |
Bu işin veya öğenin oluşturulduğu zaman damgası (unix dönemlerinde). |
| error |
Hata |
|
| events |
Event[] |
Kuyruğa alınmış, çalıştırılan ve tamamlanan dahil olmak üzere ince ayar çalıştırmasının ilerleme durumunu gösteren olaylar. |
| 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. |
| hyperparams |
Hiper Parametreler |
|
| id |
string |
Bu öğenin kimliği. |
| model |
string minLength: 1 |
İnce ayar için kullanılan temel modelin tanımlayıcısı (model-kimliği). |
| object |
TypeDiscriminator |
|
| organisation_id |
string |
Bu ince ayar işinin kuruluş kimliği. Azure OpenAI'de kullanılmadı; yalnızca OpenAI uyumluluğu. |
| result_files |
File[] |
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 |
Devlet |
|
| suffix |
string |
hassas ayarlı modeli tanımlamak için kullanılan sonek. |
| training_files |
File[] |
hassas ayarlı modeli eğiten dosya kimlikleri (dosya kimliği). |
| updated_at |
integer (unixtime) |
Bu işin veya öğenin en son değiştirildiği zaman damgası (unix dönemlerinde). |
| user_id |
string |
Bu ince ayar işinin kullanıcı kimliği. Azure OpenAI'de kullanılmadı; yalnızca OpenAI uyumluluğu. |
| validation_files |
File[] |
Eğitim sırasında ince ayarlanmış modeli değerlendirmek için kullanılan dosya kimlikleri (dosya kimliği). |
FineTuneCreation
FineTuneCreation
| Name | Tür | Description |
|---|---|---|
| batch_size |
integer (int32) |
Eğitim için kullanılacak toplu iş boyutu. Toplu iş boyutu, tek 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 daha 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. |
| classification_betas |
number[] (double) |
Sınıflandırma beta değerleri. Bu sağlanırsa, belirtilen beta değerlerinde F-beta puanlarını hesaplarız. F-beta puanı, F-1 puanının genelleştirilmesidir. Bu yalnızca ikili sınıflandırma için kullanılır. 1 beta (yani F-1 puanı) ile duyarlık ve yakalama aynı ağırlıkta verilir. Daha büyük bir beta puanı, geri çağırmaya daha fazla ağırlık ve daha az duyarlık getirir. Daha küçük bir beta puanı, duyarlık üzerinde daha fazla ağırlık ve geri çağırmaya daha az ağırlık getirir. |
| classification_n_classes |
integer (int32) |
Sınıflandırma görevindeki sınıfların sayısı. Bu parametre çok sınıflı sınıflandırma için gereklidir. |
| classification_positive_class |
string |
İkili sınıflandırmadaki pozitif sınıf. İkili sınıflandırma yapılırken duyarlık, geri çağırma ve F1 ölçümleri oluşturmak için bu parametre gereklidir. |
| compute_classification_metrics |
boolean |
Sınıflandırma ölçümlerinin hesaplanıp hesaplanmayacağını gösteren değer. Ayarlanırsa, her dönem sonundaki doğrulama kümesini kullanarak doğruluk ve F-1 puanı gibi sınıflandırmaya özgü ölçümleri hesaplarız. Bu ölçümler sonuçlar dosyasında görüntülenebilir. Sınıflandırma ölçümlerini hesaplamak için bir validation_file sağlamanız gerekir. Ayrıca, çok sınıflı sınıflandırma için classification_n_classes veya ikili sınıflandırma için classification_positive_class belirtmeniz gerekir. |
| learning_rate_multiplier |
number (double) |
Eğitim için kullanılacak öğrenme oranı çarpanı. İnce ayarlama öğrenme oranı, ön eğitim için kullanılan özgün öğrenme oranıdır ve bu değerle çarpılır. Daha büyük öğrenme oranları, 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. |
| model |
string minLength: 1 |
Bu ince ayar için kullanılan temel modelin tanımlayıcısı (model-kimliği). |
| n_epochs |
integer (int32) |
Modeli eğitmek için dönem sayısı. Dönem, eğitim veri kümesindeki bir tam döngüyü ifade eder. |
| prompt_loss_weight |
number (double) |
İstem belirteçlerinde kayıp için kullanılacak ağırlık. Bu, modelin istem oluşturmayı (her zaman ağırlığı 1,0 olan tamamlama ile karşılaştırıldığında) ne kadar öğrenmeye çalıştığını denetler ve tamamlamalar kısa olduğunda eğitime dengeleyici bir etki ekleyebilir. İstemler son derece uzunsa (tamamlanmalara göre), istemleri aşırı önceliklendirmemek için bu ağırlığı azaltmak mantıklı olabilir. |
| suffix |
string |
hassas 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. |
| training_file |
string minLength: 1 |
Bu hassas ayarlı modelin eğitimi için kullanılan dosya kimliği (dosya kimliği). |
| validation_file |
string |
Eğitim sırasında ince ayarlanmış modeli değerlendirmek için kullanılan dosya kimliği (file-id). |
HyperParameters
Hiper Parametreler
| Name | Tür | Description |
|---|---|---|
| batch_size |
integer (int32) |
Eğitim için kullanılacak toplu iş boyutu. Toplu iş boyutu, tek 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 daha 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. |
| classification_betas |
number[] (double) |
Sınıflandırma beta değerleri. Bu sağlanırsa, belirtilen beta değerlerinde F-beta puanlarını hesaplarız. F-beta puanı, F-1 puanının genelleştirilmesidir. Bu yalnızca ikili sınıflandırma için kullanılır. 1 beta (yani F-1 puanı) ile duyarlık ve yakalama aynı ağırlıkta verilir. Daha büyük bir beta puanı, geri çağırmaya daha fazla ağırlık ve daha az duyarlık getirir. Daha küçük bir beta puanı, duyarlık üzerinde daha fazla ağırlık ve geri çağırmaya daha az ağırlık getirir. |
| classification_n_classes |
integer (int32) |
Sınıflandırma görevindeki sınıfların sayısı. Bu parametre çok sınıflı sınıflandırma için gereklidir. |
| classification_positive_class |
string |
İkili sınıflandırmadaki pozitif sınıf. İkili sınıflandırma yapılırken duyarlık, geri çağırma ve F1 ölçümleri oluşturmak için bu parametre gereklidir. |
| compute_classification_metrics |
boolean |
Sınıflandırma ölçümlerinin hesaplanıp hesaplanmayacağını gösteren değer. Ayarlanırsa, her dönem sonundaki doğrulama kümesini kullanarak doğruluk ve F-1 puanı gibi sınıflandırmaya özgü ölçümleri hesaplarız. Bu ölçümler sonuçlar dosyasında görüntülenebilir. Sınıflandırma ölçümlerini hesaplamak için bir validation_file sağlamanız gerekir. Ayrıca, çok sınıflı sınıflandırma için classification_n_classes veya ikili sınıflandırma için classification_positive_class belirtmeniz gerekir. |
| learning_rate_multiplier |
number (double) |
Eğitim için kullanılacak öğrenme oranı çarpanı. İnce ayarlama öğrenme oranı, ön eğitim için kullanılan özgün öğrenme oranıdır ve bu değerle çarpılır. Daha büyük öğrenme oranları, 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 (int32) |
Modeli eğitmek için dönem sayısı. Dönem, eğitim veri kümesindeki bir tam döngüyü ifade eder. |
| prompt_loss_weight |
number (double) |
İstem belirteçlerinde kayıp için kullanılacak ağırlık. Bu, modelin istem oluşturmayı (her zaman ağırlığı 1,0 olan tamamlama ile karşılaştırıldığında) ne kadar öğrenmeye çalıştığını denetler ve tamamlamalar kısa olduğunda eğitime dengeleyici bir etki ekleyebilir. İstemler son derece uzunsa (tamamlanmalara göre), istemleri aşırı önceliklendirmemek için bu ağırlığı azaltmak mantıklı olabilir. |
InnerError
InnerError
| Name | Tür | Description |
|---|---|---|
| code |
InnerErrorCode |
|
| innererror |
InnerError |
InnerErrorCode
InnerErrorCode
| Değer | Description |
|---|---|
| invalidPayload |
İstek verileri bu işlem için geçersiz. |
LogLevel
LogLevel
| Değer | Description |
|---|---|
| info |
Bu olay yalnızca bilgi içindir. |
| warning |
Bu olay, azaltılmış bir sorunu temsil eder. |
| error |
Bu ileti kurtarılamayan bir sorunu temsil eder. |
Purpose
Amaç
| Değer | Description |
|---|---|
| fine-tune |
Bu dosya ince ayar işi için eğitim verileri içerir. |
| fine-tune-results |
Bu dosya ince ayar işinin sonuçlarını içerir. |
State
Devlet
| Değer | Description |
|---|---|
| notRunning |
İşlem oluşturuldu ve gelecekte işlenmek üzere kuyruğa alınmadı. |
| running |
İşlem işlenmeye başlandı. |
| succeeded |
İşlem başarıyla işlendi ve tüketime hazır. |
| canceled |
İşlem iptal edildi ve tamamlanmadı. |
| failed |
İşlem bir hatayla işlemeyi tamamladı ve daha fazla kullanılamaz. |
| deleted |
Varlık silindi, ancak silme işlemini önceden hazırleyen diğer varlıklar tarafından yine de başvurulabilir. |
TypeDiscriminator
TypeDiscriminator
| Değer | Description |
|---|---|
| list |
Bu nesne, diğer nesnelerin listesini temsil eder. |
| fine-tune |
Bu nesne ince ayar işini temsil eder. |
| file |
Bu nesne bir dosyayı temsil eder. |
| fine-tune-event |
Bu nesne, ince ayar işinin olayını temsil eder. |
| model |
Bu nesne bir modeli temsil eder (temel modeller veya ince ayar iş sonucu olabilir). |