Files - Upload
Hiermee maakt u een nieuwe bestandsentiteit door gegevens te uploaden vanaf een lokale computer. Geüploade bestanden kunnen bijvoorbeeld worden gebruikt voor het trainen of evalueren van nauwkeurig afgestemde modellen.
POST {endpoint}/openai/files?api-version=2024-05-01-preview
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
file
|
formData | True |
file |
Hiermee wordt het bestand opgehaald of ingesteld voor uploaden naar Azure OpenAI. |
purpose
|
formData | True |
Het beoogde doel van de geüploade documenten. Gebruik 'fine-tune' om af te stemmen. Hiermee kunnen we de indeling van het geüploade bestand valideren. |
|
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
Media Types: "multipart/form-data"
Name | Vereist | Type | Description |
---|---|---|---|
api-key | True |
string |
Geef hier uw Azure OpenAI-accountsleutel voor Cognitive Services op. |
Antwoorden
Name | Type | Description |
---|---|---|
201 Created |
Het bestand is gemaakt. Kopteksten Location: string |
|
Other Status Codes |
Er is een fout opgetreden. |
Beveiliging
api-key
Geef hier uw Azure OpenAI-accountsleutel voor Cognitive Services op.
Type:
apiKey
In:
header
Voorbeelden
Upload a file.
Voorbeeldaanvraag
POST https://aoairesource.openai.azure.com/openai/files?api-version=2024-05-01-preview
Voorbeeldrespons
location: https://aoairesource.openai.azure.com/openai/files/file-181a1cbdcdcf4677ada87f63a0928099
{
"status": "pending",
"purpose": "fine-tune",
"filename": "puppy.jsonl",
"id": "file-181a1cbdcdcf4677ada87f63a0928099",
"created_at": 1646126127,
"object": "file"
}
Definities
Name | Description |
---|---|
Error |
Fout |
Error |
ErrorCode |
Error |
ErrorResponse |
File |
File |
File |
FileState |
Inner |
InnerError |
Inner |
InnerErrorCode |
Purpose |
Doel |
Type |
TypeDiscriminator |
Error
Fout
Name | Type | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
De foutdetails, indien beschikbaar. |
innererror |
InnerError |
|
message |
string |
Het bericht van deze fout. |
target |
string |
De locatie waar de fout is opgetreden, indien beschikbaar. |
ErrorCode
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
ErrorResponse
Name | Type | Description |
---|---|---|
error |
Fout |
File
File
Name | Type | Description |
---|---|---|
bytes |
integer |
De grootte van dit bestand indien beschikbaar (kan null zijn). Bestandsgrootten groter dan 2^53-1 worden niet ondersteund om compatibiliteit met gehele JavaScript-getallen te garanderen. |
created_at |
integer |
Een tijdstempel wanneer deze taak of dit item is gemaakt (in unix-epochs). |
filename |
string |
De naam van het bestand. |
id |
string |
De identiteit van dit item. |
object |
TypeDiscriminator |
|
purpose |
Doel |
|
status |
FileState |
|
status_details |
string |
Het foutbericht met details voor het geval de verwerking van dit bestand is mislukt. |
FileState
FileState
Name | Type | Description |
---|---|---|
deleted |
string |
De entiteit is verwijderd, maar kan nog steeds worden verwezen door andere entiteiten die dateren van vóór de verwijdering. Het kan worden gecategoriseerd als een terminale status. |
deleting |
string |
De entiteit is ni het proces dat moet worden verwijderd. Deze status wordt niet geretourneerd door Azure OpenAI en wordt alleen beschikbaar gesteld voor compatibiliteit. Het kan worden gecategoriseerd als een actieve status. |
error |
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 gemaakt en wordt niet in de wachtrij geplaatst om in de toekomst te worden verwerkt. Het kan worden gecategoriseerd als een inactieve status. |
processed |
string |
De bewerking is verwerkt en is gereed voor gebruik. Het kan worden gecategoriseerd als een terminale status. |
running |
string |
De bewerking is gestart. Het kan worden gecategoriseerd als een actieve status. |
uploaded |
string |
Het bestand is geüpload, maar is nog niet verwerkt. Deze status wordt niet geretourneerd door Azure OpenAI en wordt alleen beschikbaar gesteld voor compatibiliteit. Het kan worden gecategoriseerd als een inactieve status. |
InnerError
InnerError
Name | Type | Description |
---|---|---|
code |
InnerErrorCode |
|
innererror |
InnerError |
InnerErrorCode
InnerErrorCode
Name | Type | Description |
---|---|---|
invalidPayload |
string |
De aanvraaggegevens zijn ongeldig voor deze bewerking. |
Purpose
Doel
Name | Type | Description |
---|---|---|
assistants |
string |
Dit bestand bevat gegevens die in assistenten moeten worden gebruikt. |
assistants_output |
string |
Dit bestand bevat de resultaten van een assistent. |
fine-tune |
string |
Dit bestand bevat trainingsgegevens voor een taak voor het afstemmen. |
fine-tune-results |
string |
Dit bestand bevat de resultaten van een taak voor het afstemmen. |
TypeDiscriminator
TypeDiscriminator
Name | Type | Description |
---|---|---|
file |
string |
Dit object vertegenwoordigt een bestand. |
fine_tuning.job |
string |
Dit object vertegenwoordigt een taak om af te stemmen. |
fine_tuning.job.checkpoint |
string |
Dit object vertegenwoordigt een controlepunt van een taak voor het afstemmen. |
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). |