Studii-API

Rufen Sie jedes Studii-Werkzeug von Ihrem eigenen Server, Skript oder Produkt aus auf. Pro-Tarif und höher.

Authentifizierung

Stellen Sie einen Schlüssel aus unter /app/settings/api-keys. Senden Sie ihn bei jeder Anfrage als Bearer-Token (oder über x-api-key):

Authorization: Bearer stu_<your-key>

Einen Auftrag erstellen

Reicht eine Generierung ein. Gibt sofort die Auftrags-ID zurück; fragen Siestatus_urlab, bis der Status completed oder failed.

POST https://studii.tech/api/v1/jobs
Authorization: Bearer stu_<your-key>
Content-Type: application/json

{
  "tool": "studio",
  "inputs": {
    "mode": "image",
    "source": "text",
    "quality": "standard",
    "aspect_ratio": "16:9",
    "prompt": "A misty pine forest at dawn, shafts of golden light"
  }
}

202-Antwort:

{
  "id": "8a1f...",
  "status": "queued",
  "status_url": "https://studii.tech/api/v1/jobs/8a1f...",
  "credits_charged": 8
}

Status abfragen

GET https://studii.tech/api/v1/jobs/<id>
Authorization: Bearer stu_<your-key>

200-Antwort:

{
  "id": "8a1f...",
  "status": "completed",
  "output_url": "https://...supabase.co/.../outputs/<key>",
  "output_kind": "image",
  "tool": "studio",
  "error": null,
  "created_at": "2026-05-14T...",
  "completed_at": "2026-05-14T...",
  "credits_charged": 8
}

Ein Quellbild hochladen

Bild-zu-Bild-Werkzeuge (virtual-staging, photo-restore, product-background, career-photo) benötigen ein Quellbild. Ablauf in zwei Schritten:

Schritt 1 — fordern Sie eine signierte URL an:

POST https://studii.tech/api/v1/uploads
Authorization: Bearer stu_<your-key>
Content-Type: application/json

{
  "filename": "kitchen.jpg",
  "content_type": "image/jpeg"
}

200-Antwort:

{
  "object_key": "8a1f.../9c3e....jpg",
  "signed_url": "https://...supabase.co/storage/v1/...?token=...",
  "token": "...",
  "expires_in": 7200
}

Schritt 2 — senden Sie die Bytes per PUT (kein Auth-Header, der Content-Type muss übereinstimmen):

curl -X PUT "$SIGNED_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@kitchen.jpg"

Schritt 3 — reichen Sie den Auftrag ein, mit source_object_key auf den zurückgegebenen object_key gesetzt:

POST https://studii.tech/api/v1/jobs
Authorization: Bearer stu_<your-key>
Content-Type: application/json

{
  "tool": "virtual-staging",
  "inputs": { "style": "modern", "room": "living" },
  "source_object_key": "8a1f.../9c3e....jpg"
}

Werkzeug-Slugs

• studio — Text- oder Bild-zu-Bild- / Videogenerierung
• virtual-staging — benötigt source_object_key
• photo-restore — benötigt source_object_key
• product-background — benötigt source_object_key
• career-photo — benötigt source_object_key (ein frontales Porträt)

Fehler

Ausgabelimits

Jeder Schlüssel kann ein Credit-Limit haben. Ist das Limit erreicht, geben Aufträge 402 zurück. Limits sind richtungsweisend — sie erstatten nicht mitten im Auftrag. Verwenden Sie ein niedriges Limit für Produktionsschlüssel, um ausufernde Kosten zu begrenzen.

Anfragelimits

Pro: 60 Anfragen/Min. pro Schlüssel. Team und Business: 300/Min. Bei Bedarf über den Support anheben.