Per funzionalità

Carica file

Usa il flusso di caricamento file della piattaforma quando un client ha solo un'immagine, un video, un audio, un PDF, un foglio di calcolo o un altro file in locale. L'API restituisce una destinazione di upload temporanea e un public_url stabile; i dettagli di implementazione dello storage restano invisibili al client.

#Scegli URL, upload o Base64

Input disponibile	Metodo consigliato	Perché
URL HTTPS pubblico esistente	Invia direttamente l'URL	Nessun upload duplicato e il corpo della richiesta più piccolo.
File locale sul dispositivo	Carica, poi invia public_url	Affidabile per i file grandi e riutilizzabile tra i tentativi.
Piccola immagine inline e il modello supporta esplicitamente Base64	Base64 è accettabile	Usalo solo quando il contratto del modello selezionato lo consente.

#Flusso di caricamento dei file locali

1
Leggi il limite attuale
Usa la stessa chiave API, così vengono applicati i limiti specifici dell'utente.
GET /v1/media/upload-policy
2
Crea una policy di upload
Invia kind, un content_type concreto e la dimensione esatta in byte.
POST /v1/media/upload-policy
3
Carica il file
Invia in POST tutte le voci di fields restituite più il file a upload_url.
multipart/form-data
4
Usa l'URL restituito
Inserisci public_url nel campo media supportato dal modello.
public_url

create-policy.sh

curl https://www.aisplice.store/v1/media/upload-policy \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "file",
    "content_type": "application/pdf",
    "size": 1048576
  }'

#Tratta i campi di upload come opachi

Invia ogni chiave e valore restituiti in fields senza rinominarli, filtrarli o metterli in cache. La policy di upload ha vita breve ed è legata a un solo percorso di file generato.

browser.ts

const form = new FormData();
for (const [key, value] of Object.entries(policy.fields)) {
  form.append(key, String(value));
}
form.append("file", file); // keep the file field last

const uploaded = await fetch(policy.upload_url, {
  method: "POST",
  body: form,
});
if (!uploaded.ok) throw new Error(await uploaded.text());

const modelInputUrl = policy.public_url;

#Tipi di file e supporto dei modelli

Upload riuscito non significa che il modello lo accetti

L'endpoint di upload può salvare file generici come PDF, Excel e testo, ma un modello può usarli solo quando il suo contratto di richiesta documenta un campo file o URL corrispondente. I modelli solo immagine non possono leggere un foglio di calcolo solo perché ha un URL pubblico.

Controlla il contratto del modello selezionato

Tutti i campi: /v1/media/upload-policy nel riferimento API →

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteModelli 3D SuccessivoNozioni di integrazione