Files - Upload

Skapar en ny filentitet genom att ladda upp data från en lokal dator. Uppladdade filer kan till exempel användas för träning eller utvärdering av finjusterade modeller.

POST {endpoint}/openai/files?api-version=2024-10-21

URI-parametrar

Name I Obligatorisk Typ Description
file
formData True

file

Hämtar eller ställer in filen som ska laddas upp till Azure OpenAI.

purpose
formData True

Purpose

Det avsedda syftet med de uppladdade dokumenten. Använd "finjustera" för finjustering. På så sätt kan vi verifiera formatet på den uppladdade filen.

endpoint
path True

string

url

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Ersätt "aoairesource" med ditt Azure OpenAI-kontonamn).

api-version
query True

string

Den begärda API-versionen.

Begärandehuvud

Media Types: "multipart/form-data"

Name Obligatorisk Typ Description
api-key True

string

Ange din Azure OpenAI-kontonyckel för Cognitive Services här.

Svar

Name Typ Description
201 Created

File

Filen har skapats.

Sidhuvuden

Location: string

Other Status Codes

ErrorResponse

Ett fel uppstod.

Säkerhet

api-key

Ange din Azure OpenAI-kontonyckel för Cognitive Services här.

Typ: apiKey
I: header

Exempel

Upload a file.

Exempelbegäran

POST https://aoairesource.openai.azure.com/openai/files?api-version=2024-10-21

Exempelsvar

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

Definitioner

Name Description
Error

Fel

ErrorCode

ErrorCode

ErrorResponse

ErrorResponse

File

Fil

FileState

FileState

InnerError

InnerError

InnerErrorCode

InnerErrorCode

Purpose

Avsikt

TypeDiscriminator

TypeDiscriminator

Error

Fel

Name Typ Description
code

ErrorCode

ErrorCode
Felkoder enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

details

Error[]

Felinformationen om den är tillgänglig.

innererror

InnerError

InnerError
Inre fel enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

message

string

Meddelandet om det här felet.

target

string

Platsen där felet inträffade om det var tillgängligt.

ErrorCode

ErrorCode

Name Typ Description
conflict

string

Den begärda åtgärden står i konflikt med det aktuella resurstillståndet.

contentFilter

string

Bildgenereringen misslyckades till följd av vårt säkerhetssystem.

fileImportFailed

string

Det gick inte att importera filen.

forbidden

string

Åtgärden är förbjuden för den aktuella användaren/API-nyckeln.

internalFailure

string

Internt fel. Försök igen.

invalidPayload

string

Begärandedata är ogiltiga för den här åtgärden.

itemDoesAlreadyExist

string

Objektet finns redan.

jsonlValidationFailed

string

Verifieringen av jsonl-data misslyckades.

notFound

string

Det går inte att hitta resursen.

quotaExceeded

string

Kvoten har överskridits.

serviceUnavailable

string

Tjänsten är inte tillgänglig för närvarande.

tooManyRequests

string

För många begäranden. Försök igen senare.

unauthorized

string

Den aktuella användar-/API-nyckeln har inte behörighet för åtgärden.

unexpectedEntityState

string

Åtgärden kan inte köras i den aktuella resursens tillstånd.

ErrorResponse

ErrorResponse

Name Typ Description
error

Error

Fel
Felinnehåll enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

File

Fil

Name Typ Description
bytes

integer

Storleken på den här filen när den är tillgänglig (kan vara null). Filstorlekar som är större än 2^53-1 stöds inte för att säkerställa kompatibilitet med JavaScript-heltal.

created_at

integer

En tidsstämpel när det här jobbet eller objektet skapades (i unix-epoker).

filename

string

Namnet på filen.

id

string

Identiteten för det här objektet.

object

TypeDiscriminator

TypeDiscriminator
Definierar typen av ett objekt.

purpose

Purpose

Avsikt
Det avsedda syftet med de uppladdade dokumenten. Använd "finjustera" för finjustering. På så sätt kan vi verifiera formatet på den uppladdade filen.

status

FileState

FileState
Tillståndet för en fil.

status_details

string

Felmeddelandet med information om bearbetningen av den här filen misslyckades.

FileState

FileState

Name Typ Description
deleted

string

Entiteten har tagits bort men kan fortfarande refereras av andra entiteter som föregått borttagningen. Den kan kategoriseras som ett terminaltillstånd.

deleting

string

Entiteten är den process som ska tas bort. Det här tillståndet returneras inte av Azure OpenAI och exponeras endast för kompatibilitet. Det kan kategoriseras som ett aktivt tillstånd.

error

string

Åtgärden har slutfört bearbetningen med ett fel och kan inte förbrukas ytterligare. Den kan kategoriseras som ett terminaltillstånd.

pending

string

Åtgärden skapades och är inte i kö för att bearbetas i framtiden. Den kan kategoriseras som ett inaktivt tillstånd.

processed

string

Åtgärden har bearbetats och är klar för förbrukning. Den kan kategoriseras som ett terminaltillstånd.

running

string

Åtgärden har börjat bearbetas. Det kan kategoriseras som ett aktivt tillstånd.

uploaded

string

Filen har laddats upp men den har ännu inte bearbetats. Det här tillståndet returneras inte av Azure OpenAI och exponeras endast för kompatibilitet. Den kan kategoriseras som ett inaktivt tillstånd.

InnerError

InnerError

Name Typ Description
code

InnerErrorCode

InnerErrorCode
Inre felkoder enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

innererror

InnerError

InnerError
Inre fel enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

InnerErrorCode

Name Typ Description
invalidPayload

string

Begärandedata är ogiltiga för den här åtgärden.

Purpose

Avsikt

Name Typ Description
assistants

string

Den här filen innehåller data som ska användas i assistenter.

assistants_output

string

Den här filen innehåller resultatet av en assistent.

batch

string

Den här filen innehåller indata för en batch.

batch_output

string

Den här filen innehåller resultatet av en batch.

fine-tune

string

Den här filen innehåller träningsdata för ett finjusterat jobb.

fine-tune-results

string

Den här filen innehåller resultatet av ett finjusterat jobb.

TypeDiscriminator

TypeDiscriminator

Name Typ Description
batch

string

Det här objektet representerar en batch.

file

string

Det här objektet representerar en fil.

fine_tuning.job

string

Det här objektet representerar ett finjusterat jobb.

fine_tuning.job.checkpoint

string

Det här objektet representerar en kontrollpunkt för ett finjusteringsjobb.

fine_tuning.job.event

string

Det här objektet representerar en händelse av ett finjusteringsjobb.

list

string

Det här objektet representerar en lista över andra objekt.

model

string

Det här objektet representerar en modell (kan vara en basmodell eller finjustera jobbresultatet).

upload

string

Det här objektet representerar en filuppladdning.

upload.part

string

Det här objektet representerar en del av en filuppladdning.