Upload File - Complete

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: 2024-10-21

Spowoduje to ukończenie przekazywania, a zwrócony obiekt Upload zawiera zagnieżdżony obiekt Plik, który jest gotowy do użycia na całej platformie. Kolejność części można zdefiniować, podając uporządkowaną listę identyfikatorów części. Łączna liczba przekazanych bajtów musi być zgodna z rozmiarem określonym pierwotnie podczas tworzenia obiektu Upload. Po zakończeniu operacji nie można dodać żadnych dodatkowych części.

POST {endpoint}/openai/uploads/{upload-id}/complete?api-version=2024-10-21

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
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.
upload-id	path	True	string	Identyfikator przekazywania.
api-version	query	True	string	Żądana wersja interfejsu API.

Nagłówek żądania

Media Types: "application/json", "text/json", "application/*+json"

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

Treść żądania

Media Types: "application/json", "text/json", "application/*+json"

Nazwa	Wymagane	Typ	Opis
part_ids	True	string[]	Lista IList'1
md5		string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	UploadResource	Sukces
Other Status Codes	ErrorResponse	Wystąpił błąd.

Zabezpieczenia

api-key

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

Typ: apiKey
W: header

Przykłady

Complete and validate a large file upload operation.

Przykładowe żądanie

HTTP

POST https://aoairesource.openai.azure.com/openai/uploads/fine-tune-72a2792ef7d24ba7b82c7fe4a37e379f/complete?api-version=2024-10-21

Przykładowa odpowiedź

Kod stanu:: 200

{
  "bytes": 2097152,
  "filename": "training_data_v21.jsonl",
  "purpose": "fine-tune",
  "status": "completed",
  "expires_at": 1646133327,
  "file": {
    "status": "processed",
    "bytes": 140,
    "purpose": "fine-tune",
    "filename": "puppy.jsonl",
    "id": "file-181a1cbdcdcf4677ada87f63a0928099",
    "created_at": 1646126127,
    "object": "file"
  },
  "id": "fine-tune-72a2792ef7d24ba7b82c7fe4a37e379f",
  "created_at": 1646126127,
  "object": "upload"
}

Definicje

Nazwa	Opis
Error	Błąd
ErrorCode	Kod błędu
ErrorResponse	ErrorResponse
File	Plik
FileState	FileState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
Purpose	Cel
TypeDiscriminator	TypeDiscriminator
UploadFileCompleteBody	UploadFileCompleteBody
UploadResource	UploadResource
UploadStatus	UploadStatus

Error

Objekt

Błąd

Nazwa	Typ	Opis
code	ErrorCode	Kod błędu 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 Błąd wewnętrzny zdefiniowany w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string minLength: 1	Komunikat o tym błędzie.
target	string	Lokalizacja, w której wystąpił błąd, jeśli jest dostępny.

ErrorCode

Wyliczanie

Kod błędu

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

ErrorResponse

Objekt

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

Objekt

Plik

Nazwa	Typ	Opis
bytes	integer (int64)	Rozmiar tego pliku, jeśli 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 (unixtime)	Sygnatura czasowa utworzenia tego zadania lub elementu (w epokach unix).
filename	string minLength: 1	Nazwa pliku.
id	string	Tożsamość tego elementu.
object	TypeDiscriminator	TypeDiscriminator Definiuje typ obiektu.
purpose	Purpose	Cel Przeznaczenie przekazanych dokumentów. Użyj polecenia "fine-tune" w celu 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

Wyliczanie

FileState

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

InnerError

Objekt

InnerError

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

InnerErrorCode

Wyliczanie

InnerErrorCode

Wartość	Opis
invalidPayload	Dane żądania są nieprawidłowe dla tej operacji.

Purpose

Wyliczanie

Cel

Wartość	Opis
assistants	Ten plik zawiera dane do użycia w asystentach.
assistants_output	Ten plik zawiera wyniki asystenta.
batch	Ten plik zawiera dane wejściowe dla partii.
batch_output	Ten plik zawiera wyniki partii.
fine-tune	Ten plik zawiera dane szkoleniowe dla zadania dostrajania.
fine-tune-results	Ten plik zawiera wyniki zadania dostrajania.

TypeDiscriminator

Wyliczanie

TypeDiscriminator

Wartość	Opis
batch	Ten obiekt reprezentuje partię.
file	Ten obiekt reprezentuje plik.
fine_tuning.job	Ten obiekt reprezentuje zadanie dostrajania.
fine_tuning.job.checkpoint	Ten obiekt reprezentuje punkt kontrolny zadania dostrajania.
fine_tuning.job.event	Ten obiekt reprezentuje zdarzenie zadania dostrajania.
list	Ten obiekt reprezentuje listę innych obiektów.
model	Ten obiekt reprezentuje model (może być modelem bazowym lub dostrajać wynik zadania).
upload	Ten obiekt reprezentuje przekazywanie pliku.
upload.part	Ten obiekt reprezentuje część przekazywania plików.