Fine Tuning - Create

Referentie

Service:: Azure AI Services

API Version:: 2023-12-01-preview

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

POST {endpoint}/openai/fine_tuning/jobs?api-version=2023-12-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.

Aanvraagkoptekst

Name	Vereist	Type	Description
api-key	True	string	Geef hier uw Azure OpenAI-accountsleutel voor Cognitive Services op.

Aanvraagbody

Name	Vereist	Type	Description
model	True	string	De id (model-id) van het basismodel dat voor deze fine-tune wordt gebruikt.
training_file	True	string	De bestandsidentiteit (bestands-id) die wordt gebruikt voor het trainen van dit verfijnde model.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters De hyperparameterinstellingen die worden gebruikt in een taak nauwkeurig afstemmen.
suffix		string	Het achtervoegsel dat wordt gebruikt om het verfijnde model te identificeren. Het achtervoegsel kan maximaal 40 tekens bevatten (a-z, A-Z, 0-9,- en _) die worden toegevoegd aan de naam van uw nauwkeurig afgestemde model.
validation_file		string	De bestandsidentiteit (bestands-id) die wordt gebruikt om het verfijnde model tijdens de training te evalueren.

Antwoorden

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

Name

Type

Description

201 Created

FineTuningJob

De fine tune is gemaakt.

Headers

Location: string

Other Status Codes

ErrorResponse

Er is een fout opgetreden.

Beveiliging

api-key

Geef hier uw Azure OpenAI-accountsleutel voor Cognitive Services op.

Type: apiKey
In: header

Voorbeelden

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

Definities

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

Error

Fout

Name	Type	Description
code	ErrorCode	ErrorCode 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	Het bericht van deze fout.
target	string	De locatie waar de fout is opgetreden, indien beschikbaar.

ErrorCode

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

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

Name	Type	Description
batch_size	integer	De batchgrootte die moet worden gebruikt voor training. De batchgrootte is het aantal trainingsvoorbeelden dat wordt gebruikt voor het trainen van één voorwaartse 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	De vermenigvuldiger van leersnelheid die moet worden gebruikt voor training. De afstemmingsfrequentie is de oorspronkelijke leersnelheid die is gebruikt voor de pre-training, vermenigvuldigd met deze waarde. Grotere leersnelheden presteren meestal beter met grotere batchgrootten. We raden u aan te experimenteren met waarden in het bereik van 0,02 tot 0,2 om te zien wat de beste resultaten oplevert.
n_epochs	integer	Het aantal tijdvakken waarvoor het model moet worden getraind. Een tijdvak verwijst naar één volledige cyclus door de trainingsgegevensset.

FineTuningJob

Name	Type	Description
created_at	integer	Een tijdstempel wanneer deze taak of dit item is gemaakt (in unix-epochs).
fine_tuned_model	string	De id (model-id) van het resulterende verfijnde model. Deze eigenschap wordt alleen ingevuld voor voltooide uitvoeringen. Gebruik deze id om een implementatie voor deductie te maken.
finished_at	integer	Een tijdstempel wanneer deze taak of dit item is voltooid (in unix-epochs).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters De hyperparameterinstellingen die worden gebruikt in een taak nauwkeurig afstemmen.
id	string	De identiteit van dit item.
model	string	De id (model-id) van het basismodel dat wordt gebruikt voor de fine-tune.
object	TypeDiscriminator	TypeDiscriminator Definieert het type van een object.
organisation_id	string	De organisatie-id van deze fine tune job. Ongebruikt op Azure OpenAI; alleen compatibiliteit voor OpenAI.
result_files	string[]	De resultaatbestandsidentiteiten (bestands-id) met metrische gegevens voor training en evaluatie in CSV-indeling. Het bestand is alleen beschikbaar voor voltooide fine-tune-uitvoeringen.
status	FineTuningState	FineTuningState De status van een finetunes-object of taak voor het afstemmen.
suffix	string	Het achtervoegsel dat wordt gebruikt om het verfijnde model te identificeren. Het achtervoegsel kan maximaal 40 tekens bevatten (a-z, A-Z, 0-9,- en _) die worden toegevoegd aan de naam van uw nauwkeurig afgestemde model.
trained_tokens	integer	Het totale aantal factureerbare tokens dat door deze taak wordt verwerkt.
training_file	string	Het bestand dat wordt gebruikt voor de training.
updated_at	integer	Een tijdstempel wanneer deze taak of dit item voor het laatst is gewijzigd (in unix-epochs).
validation_file	string	Het bestand dat wordt gebruikt om het verfijnde model tijdens de training te evalueren.

FineTuningJobCreation

Name	Type	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters De hyperparameterinstellingen die worden gebruikt in een taak nauwkeurig afstemmen.
model	string	De id (model-id) van het basismodel dat voor deze fine-tune wordt gebruikt.
suffix	string	Het achtervoegsel dat wordt gebruikt om het verfijnde model te identificeren. Het achtervoegsel kan maximaal 40 tekens bevatten (a-z, A-Z, 0-9,- en _) die worden toegevoegd aan de naam van uw nauwkeurig afgestemde model.
training_file	string	De bestandsidentiteit (bestands-id) die wordt gebruikt voor het trainen van dit verfijnde model.
validation_file	string	De bestandsidentiteit (bestands-id) die wordt gebruikt om het verfijnde model tijdens de training te evalueren.

FineTuningState

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

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

Name	Type	Description
invalidPayload	string	De aanvraaggegevens zijn ongeldig voor deze bewerking.

TypeDiscriminator

Name	Type	Description
file	string	Dit object vertegenwoordigt een bestand.
fine-tune	string	Dit object vertegenwoordigt een taak om af te stemmen.
fine-tune-event	string	Dit object vertegenwoordigt een gebeurtenis van een taak voor het afstemmen.
fine_tuning.job	string	Dit object vertegenwoordigt een taak om af te stemmen.
fine_tuning.job.event	string	Dit object vertegenwoordigt een gebeurtenis van een taak voor het afstemmen.
list	string	Dit object vertegenwoordigt een lijst met andere objecten.
model	string	Dit object vertegenwoordigt een model (kan een basismodel zijn of taakresultaat nauwkeurig afstemmen).

Delen via

Fine Tuning - Create

URI-parameters

Aanvraagkoptekst

Aanvraagbody

Antwoorden

Beveiliging

api-key

Voorbeelden

Creating a fine tune job.

Sample Request

Sample Response

Definities

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Aanvullende resources