Datei-Upload-Policy

#Upload-Policy erstellen

• kindstringerforderlich

  "image", "video", "audio" oder "file".

• content_typestringerforderlich

  Ein konkreter MIME-Type, der zu kind passt. file akzeptiert MIME-Types außerhalb von Bild/Video/Audio, etwa application/pdf oder text/plain.

• sizeintegererforderlich

  Exakte Dateigröße in Bytes. Rufen Sie diesen Endpunkt mit demselben API-Schlüssel per GET auf, um alle vier nutzerspezifischen Limits zu lesen.

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

{
  "upload_url": "https://uploads.example.com/",
  "public_url": "https://media.example.com/media/user-upload/image/...",
  "fields": {
    "key": "media/user-upload/image/...",
    "policy": "...",
    "...": "Pass every returned field unchanged"
  },
  "expires_at": "2026-07-25T10:05:00Z"
}

#In den Dateispeicher hochladen

Senden Sie jeden zurückgegebenen fields-Eintrag und die Datei in einem einzigen Multipart-POST an upload_url. Die Policy läuft nach fünf Minuten ab, ist an einen generierten Dateipfad gebunden und kann keine vorhandene Datei überschreiben.

# Save the policy response as policy.json first.
upload_args=()
while IFS=$'\t' read -r key value; do
  upload_args+=(-F "$key=$value")
done < <(jq -r '.fields | to_entries[] | [.key, .value] | @tsv' policy.json)

# Keep the file field last for storage compatibility.
curl "$(jq -r .upload_url policy.json)" \
  "${upload_args[@]}" \
  -F "file=@reference.avif"

#Öffentliche URL verwenden

Sobald der Dateispeicher Erfolg meldet, verwenden Sie public_url im Medienfeld, das das gewählte Modell unterstützt. Ein angenommener Upload garantiert nicht, dass jedes Modell jedes Medienformat dekodieren kann; prüfen Sie den Anfragevertrag des Modells.

{
  "model": "gpt-image-2",
  "prompt": "Turn this reference into a watercolor",
  "images": ["https://media.example.com/media/user-upload/image/..."]
}

#Zugehörige Fehler

Dieser Endpunkt meldet Fehler über error.type statt error.code; werten Sie daher die folgenden Werte zusammen mit dem Status aus.