Files - Upload

Service:

Azure AI Services

API Version:

2024-02-01

Tworzy nową jednostkę pliku, przekazując dane z komputera lokalnego. Przekazane pliki mogą na przykład służyć do trenowania lub oceniania dostosowanych modeli.

POST {endpoint}/openai/files?api-version=2024-02-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
file	formData	True	file	Pobiera lub ustawia plik do przekazania do usługi Azure OpenAI.
purpose	formData	True	Purpose	Zamierzony cel przekazanych dokumentów. Użyj polecenia "fine-tune" do dostrajania. Dzięki temu możemy zweryfikować format przekazanego pliku.
endpoint	path	True	string url	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://aoairesource.openai.azure.com. Zastąp ciąg "aoairesource" nazwą konta usługi Azure OpenAI.
api-version	query	True	string	Żądana wersja interfejsu API.

Nagłówek żądania

Media Types: "multipart/form-data"

Nazwa	Wymagane	Typ	Opis
api-key	True	string	Tutaj podaj klucz konta usługi Azure OpenAI w usługach Cognitive Services.

Odpowiedzi

Nazwa	Typ	Opis
201 Created	File	Plik został pomyślnie utworzony. Headers Location: string
Other Status Codes	ErrorResponse	Wystąpił błąd.

Zabezpieczenia

api-key

Tutaj podaj klucz konta usługi Azure OpenAI w usługach Cognitive Services.

Type: apiKey
In: header

Przykłady

Upload a file.

Sample Request

HTTP

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

Sample Response

Status code:

201

location: https://aoairesource.openai.azure.com/openai/files/file-181a1cbdcdcf4677ada87f63a0928099

Response Body

{
  "purpose": "fine-tune",
  "filename": "puppy.jsonl",
  "id": "file-181a1cbdcdcf4677ada87f63a0928099",
  "status": "notRunning",
  "created_at": 1646126127,
  "object": "file"
}

Definicje

Nazwa	Opis
Error	Błąd
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
File	File
FileState	FileState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
Purpose	Przeznaczenie
TypeDiscriminator	TypeDiscriminator

Error

Błąd

Nazwa	Typ	Opis
code	ErrorCode	ErrorCode Kody błędów zdefiniowane w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Szczegóły błędu, jeśli są dostępne.
innererror	InnerError	InnerError Wewnętrzny błąd zdefiniowany w wytycznych rest firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Komunikat o tym błędzie.
target	string	Lokalizacja, w której wystąpił błąd, jeśli jest dostępny.

ErrorCode

ErrorCode

Nazwa	Typ	Opis
conflict	string	Żądana operacja powoduje konflikt z bieżącym stanem zasobu.
contentFilter	string	Generowanie obrazu nie powiodło się w wyniku naszego systemu bezpieczeństwa.
fileImportFailed	string	Importowanie pliku nie powiodło się.
forbidden	string	Operacja jest zabroniona dla bieżącego klucza użytkownika/interfejsu API.
internalFailure	string	Błąd wewnętrzny. Spróbuj ponownie.
invalidPayload	string	Dane żądania są nieprawidłowe dla tej operacji.
itemDoesAlreadyExist	string	Element już istnieje.
jsonlValidationFailed	string	Walidacja danych jsonl nie powiodła się.
notFound	string	Nie można odnaleźć zasobu.
quotaExceeded	string	Przekroczono limit przydziału.
serviceUnavailable	string	Usługa jest obecnie niedostępna.
tooManyRequests	string	Zbyt wiele żądań. Spróbuj ponownie później.
unauthorized	string	Bieżący klucz użytkownika/interfejsu API nie jest autoryzowany dla operacji.
unexpectedEntityState	string	Nie można wykonać operacji w stanie bieżącego zasobu.

ErrorResponse

ErrorResponse

Nazwa	Typ	Opis
error	Error	Błąd Zawartość błędu zdefiniowana w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

File

File

Nazwa	Typ	Opis
bytes	integer	Rozmiar tego pliku, gdy jest dostępny (może mieć wartość null). Rozmiary plików większe niż 2^53-1 nie są obsługiwane w celu zapewnienia zgodności z liczbami całkowitymi języka JavaScript.
created_at	integer	Sygnatura czasowa utworzenia tego zadania lub elementu (w epokach unix).
filename	string	Nazwa pliku.
id	string	Tożsamość tego elementu.
object	TypeDiscriminator	TypeDiscriminator Definiuje typ obiektu.
purpose	Purpose	Przeznaczenie Zamierzony cel przekazanych dokumentów. Użyj polecenia "fine-tune" do dostrajania. Dzięki temu możemy zweryfikować format przekazanego pliku.
status	FileState	FileState Stan pliku.
status_details	string	Komunikat o błędzie ze szczegółami w przypadku niepowodzenia przetwarzania tego pliku.

FileState

FileState

Nazwa	Typ	Opis
deleted	string	Jednostka została usunięta, ale nadal może być przywoływalna przez inne jednostki przed usunięciem. Można go podzielić na stan terminalu.
deleting	string	Jednostka jest ni proces, który ma zostać usunięty. Ten stan nie jest zwracany przez usługę Azure OpenAI i uwidoczniony tylko pod kątem zgodności. Można go podzielić na aktywny stan.
error	string	Operacja zakończyła przetwarzanie z powodu błędu i nie można jej jeszcze bardziej zużyć. Można go podzielić na stan terminalu.
pending	string	Operacja została utworzona i nie jest w kolejce do przetworzenia w przyszłości. Może być sklasyfikowany jako stan nieaktywny.
processed	string	Operacja została pomyślnie przetworzona i jest gotowa do użycia. Można go podzielić na stan terminalu.
running	string	Operacja została rozpoczęta do przetworzenia. Można go podzielić na aktywny stan.
uploaded	string	Plik został przekazany, ale nie został jeszcze przetworzony. Ten stan nie jest zwracany przez usługę Azure OpenAI i uwidoczniony tylko pod kątem zgodności. Może być sklasyfikowany jako stan nieaktywny.

InnerError

InnerError

Nazwa	Typ	Opis
code	InnerErrorCode	InnerErrorCode Wewnętrzne kody błędów zgodnie z definicją w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Wewnętrzny błąd zdefiniowany w wytycznych rest firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

InnerErrorCode

Nazwa	Typ	Opis
invalidPayload	string	Dane żądania są nieprawidłowe dla tej operacji.

Purpose

Przeznaczenie

Nazwa	Typ	Opis
fine-tune	string	Ten plik zawiera dane szkoleniowe dotyczące zadania dostrajania.
fine-tune-results	string	Ten plik zawiera wyniki zadania dostrajania.

TypeDiscriminator

TypeDiscriminator

Nazwa	Typ	Opis
file	string	Ten obiekt reprezentuje plik.
fine-tune	string	Ten obiekt reprezentuje zadanie dostrajania.
fine-tune-event	string	Ten obiekt reprezentuje zdarzenie zadania dostrajania.
fine_tuning.job	string	Ten obiekt reprezentuje zadanie dostrajania.
fine_tuning.job.event	string	Ten obiekt reprezentuje zdarzenie zadania dostrajania.
list	string	Ten obiekt reprezentuje listę innych obiektów.
model	string	Ten obiekt reprezentuje model (może być modelem podstawowym lub dobrym wynikiem zadania).