Files - Upload

Referens

Tjänst:: Azure AI Services

API-version:: 2024-10-21

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.

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

HTTP

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

Exempelsvar

Statuskod:: 201

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

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

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

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

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

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

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.

Dela via

Files - Upload

URI-parametrar

Begärandehuvud

Svar

Säkerhet

api-key

Exempel

Upload a file.

Exempelbegäran

Exempelsvar

Definitioner

Error

ErrorCode

ErrorResponse

File

FileState

InnerError

InnerErrorCode

Purpose

TypeDiscriminator

Ytterligare resurser