Zum Hauptinhalt springen
POST
/
v1
/
attachments
Upload an attachment
curl --request POST \
  --url https://api.devin.ai/v1/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
"<string>"
Dieser Endpunkt lädt Dateien auf unsere Server hoch und gibt eine URL zurück, auf die Sie in Devin-Sitzungen verweisen können. Die Datei wird nicht automatisch an eine Sitzung gesendet – Sie müssen die URL in Ihre Prompts einfügen.

​
Verwendung hochgeladener Dateien

Devin erkennt Anhänge nur, wenn sie exakt im Format ATTACHMENT:"{file_url}" geschrieben sind (ATTACHMENT im Singular, komplett in Großbuchstaben). Die Zeile mit ATTACHMENT: muss im Prompt in einer eigenen Zeile stehen, und die URL muss in doppelte Anführungszeichen eingeschlossen sein.Nur die URL ohne dieses Format anzugeben, funktioniert nicht. Varianten wie ATTACHMENTS: (Plural) werden ebenfalls nicht erkannt.
Um in einer Devin-Session auf eine hochgeladene Datei zu verweisen:
  1. Laden Sie die Datei hoch, indem Sie diesen Endpoint verwenden und so eine URL erhalten
  2. Fügen Sie die URL in Ihren Prompt ein, wenn Sie eine Session erstellen oder eine Nachricht senden
  3. Formatieren Sie die URL korrekt, indem Sie ATTACHMENT:"{file_url}" in Ihrem Prompt in eine eigene Zeile schreiben

​
Komplettes Beispiel

import os
import requests

DEVIN_API_KEY = os.getenv("DEVIN_API_KEY")

# Schritt 1: Datei hochladen
with open("data.csv", "rb") as f:
    response = requests.post(
        "https://api.devin.ai/v1/attachments",
        headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
        files={"file": f}
    )
file_url = response.text

# Schritt 2: Sitzung erstellen, die auf die hochgeladene Datei verweist
session_response = requests.post(
    "https://api.devin.ai/v1/sessions",
    headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
    json={
        "prompt": f"""Bitte analysieren Sie die Daten in der angehängten CSV-Datei und erstellen Sie einen Zusammenfassungsbericht.
Konzentrieren Sie sich auf die Identifizierung von Trends und wichtigen Erkenntnissen.

ATTACHMENT:"{file_url}"
"""
    }
)

print(session_response.json())
Wichtig: Das Präfix ATTACHMENT: muss im Prompt in einer eigenen Zeile stehen, wobei die URL in doppelte Anführungszeichen gesetzt ist, genau wie oben gezeigt: ATTACHMENT:"{url}". Um mehrere Dateien anzuhängen, fügen Sie pro Datei eine Zeile ATTACHMENT:"{file_url}" hinzu.

Authorizations

​
Authorization
string
header
required

Personal API Key (apk_user_) or Service API Key (apk_)

Body

multipart/form-data
​
file
file
required

Response

Successful Response

The response is of type string.