Eingabedateien bereitstellen

Modelle mit Bild-, Video- oder Audioeingabe lesen diese als öffentliche HTTPS-URLs im input-Objekt — es gibt keinen separaten Upload-Endpunkt.

Wie Eingabedateien funktionieren

Hoste die Datei irgendwo, das sie über öffentliches HTTPS bereitstellt, und referenziere die URL dann in den input-Feldern des Modells (zum Beispiel image_url):

JSON

{
  "model": "bytedance/seedance-2-image-to-video",
  "input": {
    "image_url": "https://your-cdn.example.com/photo.jpg",
    "prompt": "cinematic slow push-in"
  }
}

Gehostete URL verwenden

Die Datei ist bereits online — übergib die URL direkt

Aus Base64-Daten

Zuerst dekodieren und speichern, dann die URL übergeben

Aus einer lokalen Datei

Zuerst in deinen eigenen Speicher hochladen, dann die URL übergeben

URL-Anforderungen

Öffentlich erreichbar — kein Login, keine Cookies und keine IP-Allow-Liste davor.
HTTPS mit gültigem Zertifikat.
Direkte Dateiantwort — die URL muss die Medienbytes zurückgeben (korrekter Content-Type), keine HTML-Vorschauseite.
Halte Dateien angemessen groß; sehr große Quellen verlangsamen die Aufgabe oder schlagen upstream fehl.

Schnelle Selbstprüfung vor dem Senden einer Aufgabe:

cURL

curl -I "https://your-cdn.example.com/photo.jpg"
# expect: HTTP/2 200 + Content-Type: image/jpeg

End-to-End-Beispiel

cURL

# 1) start the task, referencing your hosted file
curl -X POST "https://97ai.97claude.com/api/generate" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-image-to-video",
    "input": {
      "image_url": "https://your-cdn.example.com/photo.jpg",
      "prompt": "cinematic slow push-in"
    }
  }'
# → { "taskId": "task_12345678", "state": "waiting" }

# 2) poll until success / fail
curl "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer $API_KEY"

Wo Dateien hosten

Dein eigener Objektspeicher: AWS S3, Alibaba Cloud OSS, Tencent Cloud COS, Cloudflare R2 (öffentlicher Bucket oder vorsignierte URL)
Das vorhandene CDN oder der Static-File-Server deiner App
Jeder Bild-/Datei-Hosting-Dienst, der eine direkte Datei-URL zurückgibt

Vorsignierte URLs funktionieren

Zeitlich begrenzte vorsignierte URLs (S3/OSS/COS) sind in Ordnung — stelle nur sicher, dass sie während der paar Minuten der Aufgabenausführung gültig bleiben.

Häufige Probleme

403 / Hotlink-Schutz — der Host blockiert Nicht-Browser-Anfragen; deaktiviere Referer-Prüfungen oder nutze vorsignierte URLs.
HTML statt der Datei — du hast einen Freigabeseiten-Link (Google Drive, Cloud-Drive) statt einer direkten Datei-URL übergeben.
Localhost-/LAN-URLs — http://localhost/… oder private IPs sind von der Plattform nicht erreichbar.

Support

Schreibe an [email protected] oder sieh dir die modellspezifischen Seiten für die genauen input-Felder jedes Modells an.