Entwickler · API v1

Eine API.
Jedes Modell.

Bilder, Video, Audio und 3D hinter einer API, bezahlt vom selben Guthaben wie das Studio. Erstelle einen Schlüssel in den Einstellungen und installiere die CLI mit npm.

CLI installieren
npm i -g ineveo
Modelle
699
Endpunkte
9
Mindestaufladung
3 €
01 · Beispiele

Derselbe Aufruf, jede Ausgabe

Tausche die Modell-ID, um zwischen Bild, Video und Sprache zu wechseln. Die Felder richten sich nach dem Modell.

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg
Beispiel-Renderingluma/uni-v1/text-to-image
[02] Schnellstart

Der erste Render in drei Schritten

  1. 01API-Schlüssel erstellenMelde dich mit deiner E-Mail an, öffne Einstellungen, API-Schlüssel und erstelle einen Schlüssel. Lade ab 3 € unter Abrechnung auf.export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02Installiere die CLIEin Befehl: npm i -g ineveo. Sie liest deinen Schlüssel aus INEVEO_API_KEY.npm i -g ineveo
  3. 03Ersten Render startenWähle eine Modell-ID aus dem Katalog und sende einen Prompt. Mit --dry-run siehst du den Preis, ohne etwas auszugeben.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

Rendern im Terminal

Starte jedes Modell aus einer Shell, einem CI-Job oder einem Coding-Agenten. Jeder Render wird vor dem Start bepreist und aus demselben Guthaben bezahlt.

Skripte und CIJedes Feld eines Modells ist ein Flag; eine lokale Datei wird für dich hochgeladen.
JSON auf stdoutEin JSON-Dokument pro Lauf, Fortschritt und Fehler auf stderr, ein Exit-Code ungleich null bei Fehlern.
Coding-AgentenEine Skill-Datei bringt deinem Agenten bei, erst den Preis zu prüfen und ihn zu begrenzen.
Vollständige CLI-Anleitung →
BefehlWas er tut
ineveo models --type videoAlle Videomodelle mit ihrem Startpreis
ineveo run <model> -hDie Felder eines Modells, live abgerufen: Typ, Standardwert, erlaubte Werte
ineveo run <model> -p "<prompt>" -o ./out/Rendern und das Ergebnis in einem Ordner speichern
ineveo run <model> -p "..." --dry-runDer genaue Preis, ohne etwas auszugeben
ineveo run <model> -p "..." --max-price 0.50Nicht starten, wenn der Preis höher ist
ineveo run <model> -p "..." --json -o ./out/Ein JSON-Ergebnis, bereit für den nächsten Schritt
ineveo skill installBring deinem Coding-Agenten die CLI bei
[04] API-Grundlagen

Gebaut für die Produktion

Authentifizierung

Ein Bearer-Token im Authorization-Header. Erstelle Schlüssel in den Einstellungen und widerrufe jeden davon jederzeit.

Authorization: Bearer YOUR_API_KEY

Renders im Hintergrund

Der Start eines Renders antwortet sofort mit dem Status queued. Frag den Render ab, bis er erfolgreich ist, fehlschlägt oder erstattet wurde.

{ "status": "queued" }

Erst der Preis

Frag den genauen Preis deiner Eingaben ab, ohne etwas zu starten. Alle Beträge sind in Euro-Cent.

POST /api/v1/api/catalog/quote

Sichere Wiederholungen

Sende einen Idempotency-Key-Header, und eine wiederholte Anfrage wird nie doppelt berechnet.

Idempotency-Key: render-042

Limits

Jeder Schlüssel hat ein Limit pro Minute und ein optionales Tageslimit. Darüber antwortet die API mit 429.

429 Too Many Requests

Fehler und Erstattungen

JSON-Fehler mit Code und Meldung. Ein fehlgeschlagener Render wird automatisch deinem Guthaben erstattet.

{ "status": "refunded" }
[05] Referenz

Endpunkte

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

Vollständige API-Referenz →
GET/api/catalog/meDein Schlüssel und Guthaben
GET/api/catalog/modelsAlle Modelle
GET/api/catalog/models/detail?id=MODEL_IDEin Modell und seine Felder
POST/api/catalog/quotePreis für genaue Eingaben
POST/api/catalog/generationsRendering starten
GET/api/catalog/generationsDeine letzten Renderings
GET/api/catalog/generations/IDStatus eines Renderings
GET/api/catalog/generations/ID/contentDie Ergebnisdatei
DELETE/api/catalog/generations/IDRendering löschen

Lade 3 € auf und leg heute los

Erstelle in den Einstellungen einen API-Schlüssel und rufe jedes Modell auf. Die CLI gibt es auf npm. Fehlgeschlagene Renders werden erstattet.