Ineveo API: jedes Modell aus deinem eigenen Code

1 · Authentifizieren

Erstelle unter Einstellungen > API-Schlüssel einen Schlüssel. Sende ihn mit jeder Anfrage als Bearer-Token und bewahre ihn auf deinem Server auf, nie in einem Browser oder einer App.

curl

curl https://ineveo.com/api/v1/api/catalog/me \
  -H 'Authorization: Bearer YOUR_API_KEY'

2 · Modell wählen

Wähle ein Modell, um eine fertige Anfrage aus seinen eigenen Feldern zu sehen. Pflichtfelder sind ausgefüllt, jede optionale Einstellung nutzt den Standardwert des Modells.

Gewähltes Modellineveo/fast-image/text-to-image

Modellseite →

Felder
Name	Typ	Pflicht	Standard
prompt	text	ja	-
aspect_ratio	1:1 \| 2:1 \| 1:2 \| 3:1 \| 1:3 \| 21:9 \| ...	nein	1:1

3 · Rendering starten

Ein Aufruf berechnet den Preis für genau deine Eingaben und belastet dein Guthaben. Die Antwort kommt sofort mit dem Status queued zurück, das Rendering läuft im Hintergrund. Sende einen Idempotency-Key-Header, damit eine wiederholte Anfrage nie doppelt abgerechnet wird.

curl

curl -X POST https://ineveo.com/api/v1/api/catalog/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "ineveo/fast-image/text-to-image",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

Zuerst den Preis prüfen (optional)

Dieselben Eingaben, bepreist ohne etwas zu starten. Die Antwort ist in Cent.

curl

curl -X POST https://ineveo.com/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"ineveo/fast-image/text-to-image","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

4 · Abfragen und herunterladen

Frage das Rendering alle paar Sekunden ab, bis der Status succeeded, failed oder refunded ist. Bei Erfolg lädst du die Datei mit demselben Schlüssel von contentUrl herunter. Ein Textmodell liefert seine Antwort stattdessen in textOutput.

curl

curl https://ineveo.com/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl

curl https://ineveo.com/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -o result.png

Endpunkte

Basis-URL: https://ineveo.com/api/v1/api/catalog

GET	/me	Dein Schlüssel und Guthaben
GET	/models	Alle Modelle
GET	/models/detail?id=MODEL_ID	Ein Modell und seine Felder
POST	/quote	Preis für genaue Eingaben
POST	/generations	Rendering starten
GET	/generations	Deine letzten Renderings
GET	/generations/ID	Status eines Renderings
GET	/generations/ID/content	Die Ergebnisdatei
DELETE	/generations/ID	Rendering löschen

Preise und Guthaben

API-Renderings nutzen dasselbe Guthaben wie das Studio und kosten dasselbe. Alle Beträge in der API sind Eurocent: costCents ist, was ein Rendering gekostet hat, balanceCents, was übrig ist.

Fehler und Limits

Fehler kommen als JSON mit Code und Nachricht zurück. 401: Schlüssel fehlt, ist falsch oder widerrufen. 400: ein Feld ist ungültig (die Details nennen es). 402: nicht genug Guthaben. 429: zu viele Anfragen, bitte langsamer. Ein fehlgeschlagenes Rendering wird automatisch erstattet. Die genauen Limits werden zum Start der Schlüssel veröffentlicht. 403 mit einer HTML-Seite: Die Anfrage wurde gestoppt, bevor sie die API erreichte, meist wegen des User-Agent. Der Standardwert von Python-urllib wird blockiert, senden Sie einen eigenen, zum Beispiel User-Agent: my-app/1.0.