Fine Tuning - Create

Referentie

Service:: Azure AI Services

API-versie:: 2024-08-01-preview

Hiermee maakt u een taak waarmee een opgegeven model wordt aangepast op basis van een bepaald trainingsbestand. Het antwoord bevat details van de enqueued-taak, inclusief taakstatus en hyperparameters. De naam van het nauwkeurig afgestemde model wordt toegevoegd aan het antwoord zodra het is voltooid.

POST {endpoint}/openai/fine_tuning/jobs?api-version=2024-08-01-preview

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string (url)	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://aoairesource.openai.azure.com. Vervang 'aoairesource' door de naam van uw Azure OpenAI-account).
api-version	query	True	string	De aangevraagde API-versie.

Aanvraagbody

Name	Vereist	Type	Description
model	True	string minLength: 1	De id (model-id) van het basismodel dat voor deze verfijning wordt gebruikt.
training_file	True	string minLength: 1	De bestandsidentiteit (file-id) die wordt gebruikt voor het trainen van dit nauwkeurig afgestemde model.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters De hyperparameterinstellingen die worden gebruikt in een taak voor nauwkeurig afstemmen.
seed		integer (int32)	Het zaad dat wordt gebruikt voor de fijne afstemmingstaak. Het doorgeven van dezelfde seed- en taakparameters moet dezelfde resultaten opleveren, maar kan in zeldzame gevallen verschillen. Als er geen seed is opgegeven, wordt er een voor u gegenereerd.
suffix		string	Het achtervoegsel dat wordt gebruikt om het nauwkeurig afgestemde model te identificeren. Het achtervoegsel mag maximaal 40 tekens (a-z, A-Z, 0-9 en _) bevatten die worden toegevoegd aan de naam van het aangepaste model.
validation_file		string	De bestandsidentiteit (file-id) die wordt gebruikt om het nauwkeurig afgestemde model tijdens de training te evalueren.

Antwoorden

Name	Type	Description
201 Created	FineTuningJob	De fine tune is gemaakt. Kopteksten Location: string
Other Status Codes	ErrorResponse	Er is een fout opgetreden.

Name

Type

Description

201 Created

FineTuningJob

De fine tune is gemaakt.

Kopteksten

Location: string

Other Status Codes

ErrorResponse

Er is een fout opgetreden.

Beveiliging

api-key

VERIFICATIE van API-sleutel

Type: apiKey
In: header

OAuth2Auth

OAuth2-verificatie

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

Name	Description
https://cognitiveservices.azure.com/.default

Voorbeelden

Creating a fine tuning job.

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:: 201

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

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

Definities

Name	Description
Error	Fout
ErrorCode	Foutcode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningJobError	FineTuningJobError
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Object

Fout

Name	Type	Description
code	ErrorCode	Foutcode Foutcodes zoals gedefinieerd in de Microsoft REST-richtlijnen (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	De foutdetails indien beschikbaar.
innererror	InnerError	InnerError Interne fout zoals gedefinieerd in de Microsoft REST-richtlijnen (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string minLength: 1	Het bericht van deze fout.
target	string	De locatie waar de fout is opgetreden, indien beschikbaar.

ErrorCode

Inventarisatie

Foutcode

Waarde	Description
conflict	De aangevraagde bewerking conflicteert met de huidige resourcestatus.
contentFilter	Het genereren van installatiekopieën is mislukt als gevolg van ons veiligheidssysteem.
fileImportFailed	Importeren van bestand is mislukt.
forbidden	De bewerking is verboden voor de huidige gebruiker/API-sleutel.
internalFailure	Interne fout. Probeer het opnieuw.
invalidPayload	De aanvraaggegevens zijn ongeldig voor deze bewerking.
itemDoesAlreadyExist	Het item bestaat al.
jsonlValidationFailed	Validatie van jsonl-gegevens is mislukt.
notFound	De resource is niet gevonden.
quotaExceeded	Het quotum is overschreden.
serviceUnavailable	De service is momenteel niet beschikbaar.
tooManyRequests	Te veel aanvragen. Probeer het later opnieuw.
unauthorized	De huidige sleutel van de gebruiker/API is niet geautoriseerd voor de bewerking.
unexpectedEntityState	De bewerking kan niet worden uitgevoerd in de status van de huidige resource.

ErrorResponse

Object

ErrorResponse

Name	Type	Description
error	Error	Fout Foutinhoud zoals gedefinieerd in de Microsoft REST-richtlijnen (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Object

FineTuningHyperParameters

Name	Type	Description
batch_size	integer (int32)	De batchgrootte die moet worden gebruikt voor training. De batchgrootte is het aantal trainingsvoorbeelden dat wordt gebruikt voor het trainen van één vooruit- en achterwaartse pass. Over het algemeen hebben we vastgesteld dat grotere batchgrootten meestal beter werken voor grotere gegevenssets. De standaardwaarde en de maximumwaarde voor deze eigenschap zijn specifiek voor een basismodel.
learning_rate_multiplier	number (double)	De vermenigvuldiger met leersnelheid die moet worden gebruikt voor training. Het afstemmen van de leersnelheid is het oorspronkelijke leerpercentage dat wordt gebruikt voor pretraining vermenigvuldigd met deze waarde. Grotere leersnelheden presteren meestal beter met grotere batchgrootten. We raden u aan te experimenteren met waarden in het bereik 0,02 tot 0,2 om te zien wat de beste resultaten oplevert.
n_epochs	integer (int32)	Het aantal tijdvakken waarvoor het model moet worden getraind. Een tijdsperiode verwijst naar één volledige cyclus door de trainingsgegevensset.

FineTuningJob

Object

FineTuningJob

Name	Type	Description
created_at	integer (unixtime)	Een tijdstempel waarin deze taak of dit item is gemaakt (in unix-epochs).
error	FineTuningJobError	FineTuningJobError Voor het verfijnen van taken die zijn mislukt, bevat dit meer informatie over de oorzaak van de fout.
estimated_finish	integer (int32)	De Unix-tijdstempel (in seconden) voor wanneer de taak voor het afstemmen wordt geschat. De waarde is null als de taak voor het afstemmen niet wordt uitgevoerd.
fine_tuned_model	string	De id (model-id) van het resulterende, nauwkeurig afgestemde model. Deze eigenschap is alleen ingevuld voor voltooide uitvoeringen. Gebruik deze id om een implementatie te maken voor deductie.
finished_at	integer (int32)	Een tijdstempel wanneer deze taak of dit item is voltooid (in unix-epochs).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters De hyperparameterinstellingen die worden gebruikt in een taak voor nauwkeurig afstemmen.
id	string	De identiteit van dit item.
model	string minLength: 1	De id (model-id) van het basismodel dat wordt gebruikt voor het verfijnen.
object	TypeDiscriminator	TypeDiscriminator Hiermee definieert u het type van een object.
organisation_id	string	De organisatie-id van deze taak. Ongebruikt in Azure OpenAI; alleen compatibiliteit voor OpenAI.
result_files	string[]	De resultaatbestandsidentiteiten (file-id) met metrische gegevens voor training en evaluatie in CSV-indeling. Het bestand is alleen beschikbaar voor voltooide uitvoeringen.
seed	integer (int32)	Het zaad dat wordt gebruikt voor de fijne afstemmingstaak.
status	FineTuningState	FineTuningState De status van een finetunes object of fine tuning taak.
suffix	string	Het achtervoegsel dat wordt gebruikt om het nauwkeurig afgestemde model te identificeren. Het achtervoegsel mag maximaal 40 tekens (a-z, A-Z, 0-9 en _) bevatten die worden toegevoegd aan de naam van het aangepaste model.
trained_tokens	integer (int32)	Het totale aantal factureerbare tokens dat door deze taak voor het afstemmen is verwerkt.
training_file	string minLength: 1	Het bestand dat wordt gebruikt voor training.
validation_file	string	Het bestand dat wordt gebruikt om het nauwkeurig afgestemde model tijdens de training te evalueren.

FineTuningJobCreation

Object

FineTuningJobCreation

Name	Type	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters De hyperparameterinstellingen die worden gebruikt in een taak voor nauwkeurig afstemmen.
model	string minLength: 1	De id (model-id) van het basismodel dat voor deze verfijning wordt gebruikt.
seed	integer (int32)	Het zaad dat wordt gebruikt voor de fijne afstemmingstaak. Het doorgeven van dezelfde seed- en taakparameters moet dezelfde resultaten opleveren, maar kan in zeldzame gevallen verschillen. Als er geen seed is opgegeven, wordt er een voor u gegenereerd.
suffix	string	Het achtervoegsel dat wordt gebruikt om het nauwkeurig afgestemde model te identificeren. Het achtervoegsel mag maximaal 40 tekens (a-z, A-Z, 0-9 en _) bevatten die worden toegevoegd aan de naam van het aangepaste model.
training_file	string minLength: 1	De bestandsidentiteit (file-id) die wordt gebruikt voor het trainen van dit nauwkeurig afgestemde model.
validation_file	string	De bestandsidentiteit (file-id) die wordt gebruikt om het nauwkeurig afgestemde model tijdens de training te evalueren.

FineTuningJobError

Object

FineTuningJobError

Name	Type	Description
code	string	De machineleesbare foutcode.
message	string	Het door mensen leesbare foutbericht.
param	string	De parameter die ongeldig was, meestal training_file of validation_file. Dit veld is null als de fout niet parameterspecifiek is.

FineTuningState

Inventarisatie

FineTuningState

Waarde	Description
cancelled	De bewerking is geannuleerd en is onvolledig. Deze kan worden gecategoriseerd als een terminalstatus.
created	De bewerking is gemaakt. Deze status wordt niet geretourneerd door Azure OpenAI en wordt alleen beschikbaar gemaakt voor compatibiliteit. Deze kan worden gecategoriseerd als een inactieve status.
failed	De bewerking is voltooid met een fout en kan niet verder worden verbruikt. Deze kan worden gecategoriseerd als een terminalstatus.
pending	De bewerking is nog niet in de wachtrij geplaatst om in de toekomst te worden verwerkt. Deze kan worden gecategoriseerd als een inactieve status.
running	De bewerking is gestart. Deze kan worden gecategoriseerd als een actieve status.
succeeded	De bewerking is verwerkt en is gereed voor gebruik. Deze kan worden gecategoriseerd als een terminalstatus.

InnerError

Object

InnerError

Name	Type	Description
code	InnerErrorCode	InnerErrorCode Interne foutcodes zoals gedefinieerd in de Microsoft REST-richtlijnen (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Interne fout zoals gedefinieerd in de Microsoft REST-richtlijnen (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Inventarisatie

InnerErrorCode

Waarde	Description
invalidPayload	De aanvraaggegevens zijn ongeldig voor deze bewerking.

TypeDiscriminator

Inventarisatie

TypeDiscriminator

Waarde	Description
file	Dit object vertegenwoordigt een bestand.
fine_tuning.job	Dit object vertegenwoordigt een taak voor het afstemmen.
fine_tuning.job.checkpoint	Dit object vertegenwoordigt een controlepunt van een taak voor het afstemmen.
fine_tuning.job.event	Dit object vertegenwoordigt een gebeurtenis van een taak voor het afstemmen.
list	Dit object vertegenwoordigt een lijst met andere objecten.
model	Dit object vertegenwoordigt een model (kan een basismodel zijn of taakresultaat verfijnen).
upload	Dit object vertegenwoordigt een bestand uploaden.
upload.part	Dit object vertegenwoordigt een deel van een bestandsupload.

Delen via

Fine Tuning - Create

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

api-key

OAuth2Auth

Bereiken

Voorbeelden

Creating a fine tuning job.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningJobError

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Aanvullende resources