Files - Import

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

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

URI-parametrar

Name I Obligatorisk Typ Description
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

Name Obligatorisk Typ Description
api-key True

string

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

Begärandetext

Name Obligatorisk Typ Description
content_url True

string

Url:en som dokumentet ska laddas ned från (kan vara SAS-URL för en blob eller någon annan extern URL som är tillgänglig med en GET-begäran).

filename True

string

Namnet på JSON Lines fil som ska laddas upp. Om purpose är inställt på "finjustera" är varje rad en JSON-post med fälten "prompt" och "completion" som representerar dina träningsexempel.

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

Importing a file with a blob url as source.

Exempelbegäran

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


{
  "purpose": "fine-tune",
  "filename": "puppy.jsonl",
  "content_url": "https://www.contoso.com/trainingdata/puppy.jsonl"
}

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

FileImport

FileImport

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.

FileImport

FileImport

Name Typ Description
content_url

string

Url:en som dokumentet ska laddas ned från (kan vara SAS-URL för en blob eller någon annan extern URL som är tillgänglig med en GET-begäran).

filename

string

Namnet på JSON Lines fil som ska laddas upp. Om purpose är inställt på "finjustera" är varje rad en JSON-post med fälten "prompt" och "completion" som representerar dina träningsexempel.

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.

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.