> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bild oder Video hochladen

> Ein Bild oder eine kleine Videodatei hochladen, um sie in Ihren Beitrag einzubinden

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

Dieser Endpunkt ermöglicht es Ihnen, eine Datei bzw. ein Bild oder ein kleines Video hochzuladen, das in Ihren Beitrag eingefügt werden soll. Zurückgegeben wird die URL zum Bild, die im /post-Endpunkt verwendet werden kann.

Sie können die Datei entweder als ***Multipart-Form-Data*** als Formularparameter oder als **Base64-kodierte Datei** als Body-Parameter übergeben.

Wichtige Hinweise zu Medien-Uploads:

1. Für die beste Performance empfehlen wir:
   <ul className="custom-bullets">
     <li>Hosten Sie Mediendateien auf Ihrem eigenen Server (z. B. AWS S3).</li>
     <li>Übergeben Sie die Medien-URL direkt im Parameter `mediaUrls` des Endpunkts [/post](/apis/post/overview).</li>
     <li>Dieser Ansatz ist schneller als das Hochladen von Dateien über diesen Endpunkt.</li>
   </ul>

2. Aufbewahrung von Mediendateien

   <ul className="custom-bullets">
     <li>Hochgeladene Dateien werden 90 Tage lang gespeichert.</li>
     <li>Nach 90 Tagen:</li>

     <ul className="custom-bullets">
       <li>Veröffentlichte Beiträge in sozialen Netzwerken bleiben unberührt.</li>
       <li>Geplante Beiträge können nicht veröffentlicht werden, wenn sie auf abgelaufene Medien verweisen.</li>
     </ul>
   </ul>

3. Dateigrößenbeschränkungen
   <ul className="custom-bullets">
     <li>Maximale Dateigröße: 30 MB.</li>
     <li>Für größere Dateien siehe unseren Leitfaden zum [Umgang mit großen Medien-Uploads](/apis/media/upload-large-media).</li>
   </ul>

<Tip>Wenn Ihre Medien bereits über eine externe URL zugänglich sind, etwa über einen S3-Bucket, können Sie den Upload der Dateien zu Ayrshare überspringen. Senden Sie einfach eine POST-Anfrage an den `/post`-Endpunkt mit Ihrer extern zugänglichen URL im Body-Parameter `mediaURLs`, und Ihre Datei wird automatisch hochgeladen.</Tip>

## Header-Parameter

<HeaderAPI noProfileKey={true} />

<ParamField body="Content-Type" type="string" required>
  Verwenden Sie `multipart/form-data`, wenn Sie Multipart-Form-Data senden – siehe unten. Andernfalls senden Sie das übliche `application/json`.
</ParamField>

## Body-Parameter

<ParamField body="file" type="string or object" required>
  Maximale Dateigröße 30 MB.

  Wir empfehlen, die Datei als Multipart-Form-Data-Objekt zu senden anstelle einer Base64-Kodierung.
</ParamField>

<ParamField body="fileName" type="string">
  Der Name der hochzuladenden Datei.
</ParamField>

<ParamField body="description" type="string">
  Eine Beschreibung der Datei.
</ParamField>

### Als Multipart-Form-Data senden

Senden Sie die Mediendatei als Multipart-Form-Data-Objekt. Achten Sie darauf, den `Content-Type` wie oben erwähnt anzugeben.

### Als Base64 senden

Senden Sie die Mediendatei als Base64-kodierten String im Data-URI-Format. Der String sollte mit `data:content/type;base64` beginnen.

Beispiel-Kodierung mit Ausgabeformat Data URI:

<ul className="custom-bullets">
  <li>Bild: [https://base64.guru/converter/encode/image](https://base64.guru/converter/encode/image)</li>
  <li>Video: [https://base64.guru/converter/encode/video](https://base64.guru/converter/encode/video)</li>
</ul>

Hinweis: Der /post-Endpunkt akzeptiert größere Dateien über eine externe URL mit dem Parameter `mediaUrls`.

<RequestExample>
  ```bash cURL theme={"system"}
  # Send as Multipart Form-Data
  curl \
  -H "Authorization: Bearer API_KEY" \
  -F "file=@test.png" \
  -F "fileName=test.png" \
  -F "description=best image" \
  -X POST https://api.ayrshare.com/api/media/upload

  # Send as Base64
  curl \
  -H "Authorization: Bearer API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"file": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...", "fileName": "test.png", "description": "best image"}' \
  -X POST https://api.ayrshare.com/api/media/upload
  ```

  ```javascript JavaScript theme={"system"}
  // Send as Multipart Form-Data
  const FormData = require('form-data');
  const fs = require('fs');

  const API_KEY = "API_KEY";
  const imagePath = './test.png';

  const form = new FormData();
  form.append('file', fs.createReadStream(imagePath));
  form.append('fileName', 'test.png');
  form.append('description', 'best image');

  fetch("https://api.ayrshare.com/api/media/upload", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`
      // Don't set Content-Type header - FormData will set it automatically with boundary
    },
    body: form
  })
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(console.error);

  // Send as Base64
  const API_KEY = "API_KEY";
  const base64 = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

  fetch("https://api.ayrshare.com/api/media/upload", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "Authorization": `Bearer ${API_KEY}`
        },
        body: JSON.stringify({
          file: base64,
          fileName: "test.png",
          description: "best image"
        }),
      })
        .then((res) => res.json())
        .then((json) => console.log(json))
        .catch(console.error);
  ```

  ```python Python theme={"system"}
  # Send as Multipart Form-Data
  import requests

  # For a local file:
  files = {
      'file': ('test.png', open('test.png', 'rb')),
  }

  # Form data
  data = {
      'fileName': 'test.png',
      'description': 'best image'
  }
  headers = {
      'Authorization': 'Bearer API_KEY'
  }

  r = requests.post(
      'https://api.ayrshare.com/api/media/upload',
      files=files,
      data=data,
      headers=headers
  )

  print(r.json())

  # Send as Base64
  import requests

  payload = {'file': 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...',
          'fileName': "test.png",
          'description': "best image"}
  headers = {'Content-Type': 'application/json',
          'Authorization': 'Bearer API_KEY'}

  r = requests.post('https://api.ayrshare.com/api/media/upload',
      json=payload,
      headers=headers)

  print(r.json())
  ```

  ```php PHP theme={"system"}
  # Send as Multipart Form-Data
  <?php
    // Generate a boundary string
    $boundary = uniqid();

    // Open the file
    $file = file_get_contents('test.png');

    // Build the multipart form data
    $data = '';
    $data .= "--" . $boundary . "\r\n";
    $data .= 'Content-Disposition: form-data; name="file"; filename="test.png"' . "\r\n";
    $data .= "Content-Type: image/png\r\n\r\n";
    $data .= $file . "\r\n";

    $data .= "--" . $boundary . "\r\n";
    $data .= 'Content-Disposition: form-data; name="fileName"' . "\r\n\r\n";
    $data .= "test.png\r\n";

    $data .= "--" . $boundary . "\r\n";
    $data .= 'Content-Disposition: form-data; name="description"' . "\r\n\r\n";
    $data .= "best image\r\n";

    $data .= "--" . $boundary . "--\r\n";

    // Setup the context for the request
    $options = [
        'http' => [
            'method' => 'POST',
            'header' => "Authorization: Bearer API_KEY\r\n" .
                      "Content-Type: multipart/form-data; boundary=" . $boundary . "\r\n" .
                      "Content-Length: " . strlen($data) . "\r\n",
            'content' => $data
        ]
    ];

    // Send the request
    $context = stream_context_create($options);
    $result = file_get_contents('https://api.ayrshare.com/api/media/upload', false, $context);

    // Print the response
    echo $result;

  # Send as Base64
  <?php
  $data = [
      'file' => 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...',
      'fileName' => "test.png",
      'description' => "best image"
  ];

  $ch = curl_init('https://api.ayrshare.com/api/media/upload');
  curl_setopt($ch, CURLOPT_POST, 1);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Content-Type: application/json',
      'Authorization: Bearer API_KEY'
  ]);

  $response = curl_exec($ch);
  curl_close($ch);

  echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
  ```
</RequestExample>

<ResponseExample>
  ```javascript 200: Success theme={"system"}
  {
      "id": "1167335b-6c37-4fc6-ab8a-044e0005d335-jpeg",
      "url": "https://images.ayrshare.com/q3Ls85VTsrbODnGIJHpy7PaHWwA3/1167335b-6c37-4fc6-ab8a-044ed885d.jpeg",
      "fileName": "fun.jpg",
      "description": "good times"
  }
  ```

  ```json 400: Bad Request Error in upload theme={"system"}
  {
    "action": "request",
    "status": "error",
    "code": 101,
    "message": "Missing or incorrect parameters. Please verify with the docs. .../ayrshare.com/rest-api/endpoints"
  }
  ```
</ResponseExample>