NeuSo erkennen wir Verkäufer, die das falsche Modell anbieten – und du bekommst dein Geld zurück.

Bilder, Video, Musik und Sprache

Der Schlüssel, den Sie für Text verwenden, erstellt auch Bilder, Videos, Musik und Sprache und wandelt Aufnahmen in Text um, vom selben Guthaben. Wählen Sie ein Modell in der Modelltabelle (oder ?type=image, ?type=music, ?type=audio); auf jeder Modellseite werden Preis, Typ und eine funktionierende Anfrage angezeigt.

Sie möchten Route Quellbild geht in
Ein neues Bild aus einem Prompt POST /v1/images/generations (keine)
Ein bearbeitetes Bild POST /v1/images/edits image (oder image_url, input_images, images)
Ein Video aus einem Prompt POST /v1/video/generations (keine)
Ein Video, das mit einem Bild beginnt POST /v1/video/generations image_url (erstes Frame); end_image_url für das letzte Frame
Ein Video aus Referenzbildern POST /v1/video/generations input_images mit "role": "reference"
Eine Textantwort zu einem Bild POST /v1/chat/completions ein image_url part in messages[].content
Musik POST /v1/music/generations (keine)
Sprache aus Text POST /v1/audio/speech (keine)
Text aus einer Aufnahme POST /v1/audio/transcriptions (keine; die Aufnahme geht in file)

Ein Quellbild ist ein https:// Link, ein data: URI (data:image/png;base64,iVBORw0…) oder einfaches base64 eines PNG, JPEG oder WebP, bis zu 8 pro Anfrage. Die Bild-Routen akzeptieren auch einen Multipart-Upload (siehe unten). Links müssen öffentliche https:// Links sein; http:// Links werden abgelehnt. Ein Link, der weiterleitet (zum Beispiel https://picsum.photos/640/360), wird bis zu 5 Mal verfolgt und nur zu anderen öffentlichen https:// Links, und das Modell erhält den Link, auf dem es landet. Ein Link, der nicht zu einem Bild führt oder an einen Ort weiterleitet, den wir nicht verwenden können, wird mit 400 invalid_image_url abgelehnt, bevor etwas reserviert oder berechnet wird. Inline gesendete Bilder machen die Anfrage größer: Halten Sie sie unter 10 MB, oder senden Sie Links.

In einer Chat-Nachricht (image_url in messages[].content) wird ein Link (https:// oder http://) von MartLLM geöffnet und als data: URL an das Modell gesendet, da die meisten Vision-Modelle nur dies akzeptieren. Jedes Bild kann bis zu 20 MB groß sein (40 MB pro Anfrage), und Weiterleitungen werden bis zu 5 Mal verfolgt, nur zu öffentlichen Adressen. Gemini-Modelle erhalten den Link, wie er ist. Ein Link, der nicht zu einem Bild führt, wird mit 400 invalid_image_url abgelehnt, und es wird nichts berechnet.

Bild erstellen

Bilder kommen in der Antwort zurück.

curl https://api.martllm.com/v1/images/generations \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "venice/z-image-turbo", "prompt": "a red apple on a white table", "n": 1, "size": "1024x1024"}'
{ "created": 1792429247, "data": [{ "url": "https://api.martllm.com/v1/media/artifacts/<id>/0" }],
  "usage": { "cost_usd": 0.0099, "max_cost_usd": 0.0109 } }

usage.cost_usd ist, was das Bild gekostet hat (auch im X-UberLLM-Cost-USD Header). In der seltenen Antwort, wo der Preis noch nicht bekannt ist, ist er null. Sie zahlen, was der Anbieter berechnet hat, nie mehr als max_cost_usd, was dafür reserviert wurde.

response_format ist standardmäßig url, für /v1/images/generations und /v1/images/edits gleichermaßen. Senden Sie "response_format": "b64_json", um das Bild stattdessen in der Antwort zu erhalten. Wenn das Modell das Bild selbst zurückgibt, speichert MartLLM es als Datei Ihres Kontos für 24 Stunden und antwortet mit seinem Link (https://api.martllm.com/v1/files/file_…/content), der auch als Quellbild einer späteren Bearbeitung dient. Laden Sie eine url mit demselben Schlüssel herunter:

curl -L -o image.png -H "Authorization: Bearer $UBERLLM_API_KEY" \
  "https://api.martllm.com/v1/media/artifacts/<id>/0"

n ist 1 bis 10.

Bild bearbeiten

Nutzen Sie ein Modell, das bearbeitet (dessen ID normalerweise auf -edit endet), und senden Sie das Quellbild in image:

curl https://api.martllm.com/v1/images/edits \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/nano-banana-pro-edit", "prompt": "make the sky a sunset",
       "image": "https://example.com/skyline.png"}'

Dasselbe Bild kann als Folgendes übermittelt werden:

  • "image": "data:image/png;base64,iVBORw0…"
  • "image_url": "https://…"
  • "input_images": ["https://…", "https://…"]: das erste ist das zu bearbeitende Bild, der Rest sind Referenzen. Ein Eintrag kann auch {"url": "…", "role": "reference"} sein.
  • "images": [{"image_url": "https://…"}], das Format, das die OpenAI SDKs senden

Einfaches base64 funktioniert auch, und "input_image" wird als "image" gelesen.

Oder laden Sie die Datei hoch, wie bei der Bildbearbeitung von OpenAI:

curl https://api.martllm.com/v1/images/edits \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -F model=google/nano-banana-pro-edit -F prompt="make the sky a sunset" \
  -F [email protected]

Eine Bearbeitung ohne Quellbild wird mit 400 image_required abgelehnt. Masken (Inpainting) werden nicht unterstützt.

Ein Bild einmal hochladen

Laden Sie ein Bild auf /v1/files hoch und verwenden Sie es für 24 Stunden in so vielen Anfragen, wie Sie möchten, anstatt es in jeder Anfrage erneut zu senden:

curl https://api.martllm.com/v1/files \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -F [email protected]
{ "id": "file_3f9c…", "object": "file", "bytes": 482113, "content_type": "image/png",
  "filename": "skyline.png", "created_at": 1792540800, "expires_at": 1792627200,
  "url": "https://api.martllm.com/v1/files/file_3f9c…/content" }

Platzieren Sie dann die ID oder das url überall dort, wo ein Quellbild hingehört: "image": "file_3f9c…", "image": {"file_id": "file_3f9c…"}, "image_url": "file_3f9c…", ein Eintrag von input_images oder der Startframe eines Videos. Nur Ihr Konto kann seine Dateien verwenden.

  • PNG, JPEG, WebP, GIF, HEIC oder AVIF, jeweils bis zu 10 MB, maximal 500 pro Konto gleichzeitig gespeichert.
  • Für 24 Stunden gespeichert, dann gelöscht. GET /v1/files/{id} beschreibt eines, GET /v1/files/{id}/content lädt es herunter, DELETE /v1/files/{id} löscht es jetzt.

Video erstellen

Ein Video dauert eine Minute oder länger, daher ist es ein Auftrag: starten, überprüfen, herunterladen.

1. Starten

curl https://api.martllm.com/v1/video/generations \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "fal-ai/vidu/q3/text-to-video/turbo", "prompt": "a red ball bouncing on green grass",
       "duration_seconds": 5, "models": ["fal-ai/kling-video/v3/standard/text-to-video"]}'

models ist optional: Backup-Modelle werden der Reihe nach nur dann versucht, wenn das erste Modell gerade keinen freien Anbieter hat, damit ein ausgelasteter Moment Ihre Anfrage nicht fehlschlagen lässt (siehe Fallback-Modelle). Das obige Video dauert etwa eine Minute und kostet etwa $0.33.

Um von einem Bild aus zu starten, verwenden Sie ein Bild-zu-Video-Modell und fügen Sie image_url hinzu:

  -d '{"model": "bytedance/seedance-2-0-image-to-video", "prompt": "slow push-in as the waves roll",
       "image_url": "https://example.com/first-frame.png", "duration_seconds": 5}'

Ein Modell, das zwei Bilder mischt, benötigt auch end_image_url (den letzten Frame). Ein Bild-zu-Video- oder Referenz-zu-Video-Modell, das kein Video nur aus Text erstellen kann, wird mit 400 image_required abgelehnt, wenn die Anfrage kein Bild enthält, bevor etwas berechnet wird. Ein Referenz-zu-Video-Modell nimmt die Bilder in input_images:

  -d '{"model": "pixverse/pixverse-c1-reference-to-video", "prompt": "the cat walks across the room",
       "input_images": [{"url": "https://example.com/cat.png", "role": "reference"}],
       "aspect_ratio": "16:9", "duration_seconds": 5}'

Andere Felder, sofern das Modell sie anbietet: resolution (480p, 720p, 1080p…), aspect_ratio (16:9, 9:16, 1:1…) und audio (true / false; ein Modell ohne Toneinstellung erhält diese nicht und erstellt den Clip wie gewohnt).

Ein Bild-zu-Video-Modell, dessen Schema keine aspect_ratios auflistet (die meisten Kling, Veo, Wan und Seedance Bild-zu-Video-Modelle), erstellt den Clip in der Form Ihres Quellbildes. Senden Sie ein Bild, das bereits die gewünschte Form hat (für einen vertikalen Clip auf 9:16 zuschneiden) und lassen Sie aspect_ratio weg. Eine an ein solches Modell gesendete Form wird mit 400 invalid_request beantwortet, bevor etwas berechnet wird ("aspect_ratio": "auto" wird akzeptiert und bedeutet dasselbe wie das Weglassen).

Ein Referenz-zu-Video-Modell benötigt eine Form, daher wird, wenn Sie aspect_ratio weglassen, 16:9 gesendet (oder die erste Form des Modells, wenn es 16:9 nicht erstellt); das Schema des Modells zeigt diese Standardeinstellung. Die Optionen jedes Modells werden von GET /v1/models/<model id> aufgelistet (siehe Optionen jedes Modells).

Jedes Modell erstellt nur bestimmte Clip-Längen, Auflösungen und Formen. Eine Anfrage für eine, die es nicht erstellt, wird mit einer Nachricht abgelehnt, die die unterstützten auflistet, bevor etwas berechnet wird.

HTTP 202:

{
  "id": "6f1c…",
  "object": "media.job",
  "kind": "video",
  "status": "queued",
  "model": "fal-ai/vidu/q3/text-to-video/turbo",
  "estimated_cost_usd": 0.32725,
  "estimated_cost_usdc": "327250",
  "max_cost_usd": 0.359975,
  "max_cost_usdc": "359975",
  "poll_url": "/v1/video/generations/6f1c…",
  "cancel_url": "/v1/video/generations/6f1c…"
}

model ist das Modell, das den Auftrag angenommen hat (ein Backup von models, wenn das erste nicht konnte). Kosten, die auf _usdc enden, sind in Millionstel eines Dollars (327250 = $0.33). estimated_cost_usd ist der zu erwartende Preis. Er beginnt als der gelistete Preis dessen, was Sie angefordert haben (die Zahlen validate und POST /v1/quote antworten als cost_usd: der aktuelle Preis des Modells multipliziert mit den Sekunden in der angefragten Auflösung, Bildern oder anderen Einheiten). Wenn der Anbieter, der den Auftrag annimmt, erwartet, mehr als das für genau Ihre Anfrage zu berechnen, ist estimated_cost_usd stattdessen der Wert dieses Anbieters: normalerweise ab dieser ersten Antwort, und spätestens bei einer späteren GET eines noch laufenden Auftrags (manche Aufträge erhalten ihren Anbieter wenige Sekunden nach dem Start, und ein zu einem anderen Anbieter verschobener Auftrag übernimmt dessen Preis). Er steigt nur, niemals über max_cost_usd hinaus. Der Auftrag wird mit dem berechnet, was der Anbieter dafür verlangt hat: normalerweise der Schätzwert oder weniger, und in seltenen Fällen mehr (ein Clip, der aus einem Bild erstellt wurde, dessen Preis der Anbieter erst am Ende festlegt). max_cost_usd ist der Betrag, der von Ihrem Guthaben für den Auftrag einbehalten wird: derselbe Betrag während der Ausführung und nach dem Ende, und der Höchstbetrag, der für den Auftrag berechnet wird. Kein Auftrag wird jemals darüber hinaus berechnet, auch wenn der Anbieter, der ihn gestartet hat, ihn verliert und ein anderer übernimmt: Ein Anbieter, der mehr als Ihr max_cost_usd kosten würde, wird nicht verwendet. Ein Videomodell, dessen Preis pro second ist, wird pro Sekunde des Clips abgerechnet; eines, das pro job bepreist ist, kostet das pro Video.

2. Überprüfen alle 5–10 Sekunden:

curl -H "Authorization: Bearer $UBERLLM_API_KEY" \
  https://api.martllm.com/v1/video/generations/<job id>

HTTP 202 während der Auftrag läuft, HTTP 200 sobald er endet:

{
  "id": "6f1c…",
  "status": "succeeded",
  "results": [{ "artifact_index": 0, "url": "https://api.martllm.com/v1/media/artifacts/6f1c…/0",
                "content_type": "video/mp4", "duration_seconds": 5 }],
  "usage": { "cost_usdc": "40000", "cost_usd": 0.04 }
}

Das Modell meldet die genaue Abrechnung eines Auftrags kurz nachdem die Datei fertig ist, normalerweise innerhalb von 30 Sekunden. Bis dahin zeigt ein succeeded Auftrag "usage": { "cost_usd": null, "cost_pending": true }; fragen Sie ein paar Sekunden später erneut an. Wenn die Abrechnung nicht innerhalb von 30 Minuten erfolgt ist, wird der Auftrag zum gelisteten Preis (estimated_cost_usd) abgerechnet und usage.cost_note gibt dies an.

3. Herunterladen

curl -L -o video.mp4 -H "Authorization: Bearer $UBERLLM_API_KEY" \
  https://api.martllm.com/v1/media/artifacts/<job id>/0

Bitten Sie darum, einen Auftrag zu stoppen, den Sie nicht mehr benötigen: DELETE /v1/video/generations/<job id>. Wir bitten den Anbieter, ihn zu stoppen; ein bereits erstellter Auftrag wird wie gewohnt abgerechnet, und ein gestoppter Auftrag endet canceled und kostet nichts.

Fal Videomodelle

Die Modelle, deren ID mit fal-ai/ beginnt, laufen auf Fal, unter Fal's eigenem Preis: Sie zahlen Fal's Preis abzüglich des Rabatts des günstigsten Fal-Verkäufers auf dem Marktplatz im Moment (15% Rabatt auf 30. Oktober 2026; 25% Rabatt, wann immer dieser Verkäufer verkauft). Der Preis wird durch Ihre Anfrage festgelegt – Sekunden × den Tarif für die Auflösung und ob der Clip Ton hat – so sind die Kosten des Auftrags bekannt, wenn er beginnt, und estimated_cost_usd ist genau das, was abgerechnet wird. Ein fehlgeschlagener Auftrag kostet nichts. Das Stoppen eines Auftrags ist ein Best-Effort-Versuch: Wenn Fal den Clip bereits erstellt hat, wird er abgerechnet.

curl https://api.martllm.com/v1/video/generations \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "fal-ai/wan/v2.7/text-to-video", "prompt": "a woman twirls at a garden party at night",
       "duration_seconds": 15, "resolution": "720p", "aspect_ratio": "9:16"}'

Fal's eigener Preis pro Sekunde (Ihr Preis ist dieser abzüglich des Live-Rabatts; die Seite jedes Modells, GET /v1/models und POST /v1/quote, zeigen den genauen Preis jetzt):

Modell Längen (s) Fal's Preis pro Sekunde, ab
fal-ai/wan/v2.7/text-to-video, …/image-to-video 2–15 720p $0.10 · 1080p $0.15
fal-ai/kling-video/v3/standard/text-to-video, …/image-to-video 3–15 $0.084 · mit Ton $0.126
fal-ai/kling-video/v3/pro/text-to-video, …/image-to-video 3–15 $0.112 · mit Ton $0.168
fal-ai/kling-video/o3/standard/text-to-video, …/image-to-video 3–15 $0.084 · mit Ton $0.112
fal-ai/kling-video/v2.6/pro/text-to-video, …/image-to-video 5, 10 $0.07 · mit Ton $0.14
fal-ai/veo3.1/fast, fal-ai/veo3.1/fast/image-to-video 4, 6, 8 720p/1080p $0.10 · mit Ton $0.15 · 4k $0.30
fal-ai/veo3.1, fal-ai/veo3.1/image-to-video 4, 6, 8 720p/1080p $0.20 · mit Ton $0.40 · 4k $0.40
fal-ai/veo3.1/lite 4, 6, 8 720p $0.03 · mit Ton $0.05 · 1080p $0.05
fal-ai/ltx-2.3/text-to-video/fast, …/image-to-video/fast 6, 8, 10 1080p $0.06 · 1440p $0.12 · 2160p $0.24
fal-ai/ltx-2.3/text-to-video 6, 8, 10 1080p $0.08
fal-ai/minimax/hailuo-02/standard/text-to-video, …/image-to-video 6, 10 768P $0.045 · 512P (Bild) $0.017
fal-ai/vidu/q3/text-to-video/turbo, …/image-to-video/turbo 1–16 360p/540p $0.035 · 720p/1080p $0.077
fal-ai/vidu/q3/text-to-video, …/image-to-video 1–16 360p/540p $0.07 · 720p/1080p $0.154

Jeder Preis ist Fal's eigener; der Rabatt wird abgezogen, wenn der Auftrag beginnt. Wenn der günstigste Verkäufer einen Auftrag ablehnt, übernimmt ihn ein teurerer, und der Auftrag wird zu dessen Preis abgerechnet, niemals mehr als estimated_cost_usd in der Antwort.

Einige Modelle kosten uns weniger, als der Verkäuferrabatt angibt. Alle 6 Stunden vergleichen wir, was uns der Marktplatz für jedes Modell in den letzten 7 Tagen berechnet hat, mit Fal's Preis für dieselben Aufträge. Ein Modell mit mindestens 20 Aufträgen in dieser Zeit wird dann zu diesem realen Anteil plus 5% bepreist, wenn dieser niedriger ist. Die Modellseite, /v1/models und die Rechnung verwenden alle denselben Preis. Wenn dieser Wert älter als 3 Tage ist, gilt der Verkäuferrabatt erneut.

Die Felder sind unsere: duration_seconds, resolution, aspect_ratio, audio und image_url (oder input_images). Fal's eigene Schreibweise (duration, generate_audio, start_image_url) funktioniert auch. Kling, Veo und Kling 2.6 fügen Ton hinzu, es sei denn, Sie senden "audio": false.

Job-Status

status HTTP Bedeutung
queued 202 Angenommen, wartet auf den Start durch ein Modell
running 202 Wird erstellt; progress läuft von 0 bis 1, sobald das Modell dies meldet
succeeded 200 Fertig; results[].url herunterladen
failed 200 Nicht erstellt. error.message nennt den Grund; error.retryable zeigt, ob ein erneuter Versuch klappen kann
canceled 200 Gestoppt, bevor es erstellt wurde
expired 200 Nicht rechtzeitig fertiggestellt

Diese sechs sind die einzigen Werte. failed, canceled und expired kosten nichts. Ein DELETE ist eine Anfrage zum Stoppen, kein Versprechen: Ein Job, den der Provider trotzdem beendet, endet als succeeded und wird abgerechnet.

Bei hoher Auslastung wird der Versuch für dich wiederholt. Wenn kein Provider frei ist, um dein Video zu erstellen, oder einer gerade zu beschäftigt ist, startet MartLLM den Job von selbst neu – bis zu zwei weitere Male innerhalb von 10 Minuten. Dabei bleiben dieselbe Job-ID und dieselben Maximalkosten erhalten. Der Job dauert einfach nur etwas länger. Du siehst failed nur dann, wenn jeder Versuch fehlgeschlagen ist, und ein fehlgeschlagener Job kostet nichts.

Warten. Sende callback_url und wir sagen dir Bescheid, wenn der Job beendet ist (siehe Callbacks), oder frage die Poll-URL alle 5–10 Sekunden ab. Die meisten Videos dauern 1–5 Minuten; manche langen oder 4K-Jobs dauern länger. Du musst nicht ständig nachfragen, damit abgerechnet wird: Ein Job, nach dem niemand sieht, wird von MartLLM trotzdem abgeschlossen und abgerechnet (oder erstattet) und erscheint unter Dashboard → API Keys → API Usage.

Callbacks

Fügen Sie callback_url zu einem Video- oder Musik-Job hinzu: einen https:// Link auf einem öffentlichen Host. Wenn der Job endgültig abgeschlossen ist, sendet MartLLM eine POST dorthin mit demselben JSON, das GET für den Job zurückgibt.

{ "model": "kling/kling-o3", "prompt": "a red ball bouncing", "duration_seconds": 5,
  "callback_url": "https://your-app.example/uberllm/jobs" }
  • Wann. Einmal, wenn der Job beendet und seine Abrechnung final ist: succeeded mit gesetztem usage.cost_usd (niemals cost_pending), oder failed, canceled oder expired (Kosten 0). Sie wird nicht erneut gesendet, wenn die Kosten eintreffen, da sie erst danach gesendet wird. Auch bei output_upload_url kommt der Callback, nachdem der Upload abgeschlossen ist, sodass output_upload.status bereits delivered oder failed ist.
  • Header. Content-Type: application/json, MartLLM-Event: job.succeeded (oder job.failed, job.canceled, job.expired), UberLLM-Event-Id: <job id>:<status> und UberLLM-Signature: t=<unix seconds>,v1=<hex>.
  • Wiederholungen. Antworten Sie mit einem beliebigen 2xx innerhalb von 15 Sekunden. Jede andere Antwort oder keine Antwort wird nach 30 Sekunden, 2 Minuten, 10 Minuten, 30 Minuten und 2 Stunden erneut versucht und dann aufgegeben. Sie können den Job jederzeit abfragen.
  • Wiederholungen. Eine Nachricht kann mehr als einmal ankommen (zum Beispiel, wenn Ihre Antwort verloren geht). Die Event-ID bleibt gleich, also verwerfen Sie eine, die Sie bereits bearbeitet haben.
  • Status. Der Job zeigt, wie es gelaufen ist: "callback": { "status": "delivered", "attempts": 1, "http_status": 200, "delivered_at": 1792540990 }. status ist pending, delivered oder failed (mit error in einfachen Worten).
  • Der Link muss https:// auf einem öffentlichen Host sein, ohne Benutzernamen oder Passwort. Er wird niemals zurück angezeigt und gelöscht, sobald der Callback endet. webhook_url wird als dasselbe Feld gelesen. Bilder und Sprache nehmen ihn nicht an: Sie kommen in der Antwort selbst zurück.

Signatur prüfen

Jede Nachricht ist mit dem Webhook-Secret Ihres Kontos signiert. Sie finden es unter Dashboard → API keys → Webhook signing secret; es wird erstellt, wenn Sie es zum ersten Mal öffnen, und Secret ersetzen tauscht es sofort aus.

v1 ist der hex HMAC-SHA256 von <t>.<raw body>, verschlüsselt mit dem gesamten Secret (whsec_…). Berechnen Sie ihn über die empfangenen Rohbytes (bevor Sie das JSON parsen), vergleichen Sie in konstanter Zeit und lehnen Sie einen t ab, der älter als 5 Minuten ist.

Node.js (Express):

import crypto from "node:crypto";
import express from "express";

const app = express();
const SECRET = process.env.UBERLLM_WEBHOOK_SECRET; // whsec_…

app.post("/uberllm/jobs", express.raw({ type: "application/json" }), (req, res) => {
  const header = req.get("UberLLM-Signature") || "";
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=", 2)));
  const expected = crypto.createHmac("sha256", SECRET)
    .update(`${parts.t}.`).update(req.body).digest("hex");
  const ok = parts.v1 && parts.v1.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected)) &&
    Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  if (!ok) return res.status(400).send("bad signature");
  const job = JSON.parse(req.body);
  // Drop a repeat: req.get("UberLLM-Event-Id") is the same each time.
  console.log(job.id, job.status, job.usage?.cost_usd);
  res.sendStatus(204);
});

Python (Flask):

import hashlib, hmac, os, time
from flask import Flask, request, abort

app = Flask(__name__)
SECRET = os.environ["UBERLLM_WEBHOOK_SECRET"].encode()  # whsec_…

@app.post("/uberllm/jobs")
def uberllm_job():
    raw = request.get_data()  # the raw bytes, before any JSON parsing
    parts = dict(p.split("=", 1) for p in request.headers.get("UberLLM-Signature", "").split(",") if "=" in p)
    expected = hmac.new(SECRET, parts.get("t", "").encode() + b"." + raw, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(parts.get("v1", ""), expected) or abs(time.time() - int(parts.get("t", "0"))) > 300:
        abort(400)
    job = request.get_json()
    # Drop a repeat: request.headers["UberLLM-Event-Id"] is the same each time.
    print(job["id"], job["status"], job.get("usage", {}).get("cost_usd"))
    return "", 204

Benachrichtigungen an einen Webhook

Die Benachrichtigungs-E-Mails können auch an einen Webhook gesendet werden: setzen Sie einen Link unter Dashboard → Credits → For developers: also send alerts to a webhook, oder PUT /api/v1/billing/alerts {"alerts_webhook_url": "https://…"} (null schaltet es aus). Die Nachrichten werden auf dieselbe Weise wie Callbacks signiert, wiederholt und identifiziert. Der Body ist:

{ "id": "evt_…", "object": "event", "type": "balance.low", "created": 1792540990,
  "data": { "balance_usd": 4.2, "threshold_usd": 5, "message": "Your balance is $4.20, below the $5.00 you set. Requests stop once it runs out.",
            "add_credits_url": "https://martllm.com/dashboard/credits" } }
  • balance.low: der Kontostand ist unter den Betrag gefallen, den Sie für die E-Mail bei niedrigem Kontostand festgelegt haben. Wird einmal gesendet, jedes Mal, wenn er darunter fällt; es wird nichts gesendet, bis Sie einen Betrag festlegen.
  • hold.not_released: für einen Job zurückgelegtes Geld wurde mehr als 15 Minuten nach Beendigung des Jobs immer noch gehalten. data.jobs listet sie auf (id, kind, model, ended_at, held_usd) und data.held_usd ist die Summe. Das Geld gehört Ihnen immer noch und unser Team wurde benachrichtigt.

Wie lange Dateien aufbewahrt werden

Laden Sie ein Ergebnis bald nach seiner Erstellung herunter:

  • Video- und Musikdateien werden nach Beendigung des Jobs für etwa 3 Stunden aufbewahrt.
  • Bildlinks zu /v1/media/artifacts/… werden für etwa 15 Minuten aufbewahrt; Bildlinks zu /v1/files/… für 24 Stunden. Fragen Sie nach "response_format": "b64_json", um das Bild in der Antwort zu erhalten und selbst zu speichern.
  • Bilder, die Sie auf /v1/files hochladen, werden für 24 Stunden aufbewahrt.

Danach antwortet der Download 404 artifact_expired.

Ergebnisse an Ihren eigenen Speicher senden

Fügen Sie output_upload_url zu einem Video- oder Musik-Job hinzu: einen https:// Link, der einen HTTP PUT akzeptiert, wie einen vorab signierten S3, R2 oder Google Cloud Storage Upload-Link. Wenn der Job erfolgreich ist, lädt MartLLM die Datei mit ihrem Content-Type dorthin hoch. Für einen Job, der mehrere Dateien erstellt, senden Sie output_upload_urls, einen Link pro Datei in der richtigen Reihenfolge (maximal 4).

{ "model": "kling/kling-o3", "prompt": "a red ball bouncing", "duration_seconds": 5,
  "output_upload_url": "https://my-bucket.s3.amazonaws.com/ball.mp4?X-Amz-Signature=…" }

Der Status des Jobs enthält dann output_upload:

"output_upload": { "status": "delivered", "attempts": 1, "delivered_at": 1792540990,
  "files": [{ "artifact_index": 0, "http_status": 200, "bytes": 5242880 }] }
  • status ist pending, bis der Upload abgeschlossen ist, dann delivered oder failed (mit error in einfachen Worten).
  • Ein fehlgeschlagener Upload wird nach 30 Sekunden, 2, 10 und 30 Minuten erneut versucht und dann als failed markiert; die Datei kann weiterhin von results[].url heruntergeladen werden, solange sie aufbewahrt wird. Machen Sie den Link für mindestens eine Stunde gültig.
  • Der Link muss https:// auf einem öffentlichen Host sein, ohne Benutzernamen oder Passwort. Er wird niemals zurück angezeigt und gelöscht, sobald der Upload beendet ist.
  • Bilder akzeptieren dies nicht: Ein Bild kommt in der Antwort selbst zurück.

Musik

Die gleichen drei Schritte unter /v1/music/generations. curl -OJ speichert den Track unter dem Dateinamen, den wir senden.

Sprache

Text wird eingegeben, eine Audiodatei kommt als Antwort zurück.

curl https://api.martllm.com/v1/audio/speech \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "x-ai/tts-xai-v1", "input": "Hello from MartLLM."}' \
  -o speech.mp3

Sie können auch voice, response_format (zum Beispiel mp3 oder wav) und speed senden. Jedes Modell hat seine eigenen Stimmen (GET /v1/models/{id} listet sie auf). Mit best-price:speech oder fastest:speech wissen Sie im Voraus nicht, welches Modell verwendet wird, daher wird die Stimme daran angepasst: Eine Stimme, die das Modell hat, wird beibehalten, OpenAIs Namen werden der passenden Stimme des Modells zugeordnet, wo es eine gibt (alloy → af_alloy), und jede andere Stimme, oder keine, erhält die erste Stimme des Modells. Wenn Sie ein Modell benennen, wird Ihre Stimme unverändert gesendet. Es wird pro angefangene 1K Zeichen von input abgerechnet. Die Antwort ist die Audiodatei; ihr X-UberLLM-Cost-USD Header gibt an, was sie gekostet hat, und X-Request-Id ist die ID der Anfrage, wie in der Aktivität aufgeführt. "validate": true, max_cost, metadata, models und provider.max_price funktionieren wie bei Bildern (siehe Was Sie bezahlen).

Eine Aufnahme in Text umwandeln

Senden Sie die Aufnahme als Formular mit file und model:

curl https://api.martllm.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -F model=venice/whisper-large-v3 \
  -F [email protected]
{ "text": "Hello from MartLLM.", "duration": 4.2,
  "usage": { "type": "duration", "seconds": 5, "cost_usd": 0.00055, "max_cost_usd": 0.00726 } }

usage.cost_usd sind die Kosten (auch im X-UberLLM-Cost-USD Header, dem einzigen Ort für text, srt und vtt Antworten). Unsere eigenen Felder gehören ebenfalls ins Formular und werden nie an das Modell gesendet: -F max_cost=0.10, -F "metadata[project]=podcast", -F validate=true.

Sie können auch language, prompt, temperature und response_format senden:

response_format Sie erhalten
json (Standard) { "text": …, "duration": …, "usage": … }
text die Wörter als einfachen Text
srt eine Untertiteldatei mit Zeitangaben (SubRip), bereit für einen Videoeditor oder eine Anzeige
vtt dieselben Untertitel als WebVTT
verbose_json die json Antwort plus segments (id, start, end, text, in Sekunden) und, bei einem Modell, das einzelne Wörter zeitlich erfasst, words
curl https://api.martllm.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -F model=venice/whisper-large-v3 -F response_format=srt -F [email protected] -o captions.srt
1
00:00:00,330 --> 00:00:03,150
This serum is the one thing I use every morning.

2
00:00:03,300 --> 00:00:06,420
It took two weeks to see a change, now I never skip it.

venice/whisper-large-v3 gibt einen Untertitel pro Satz; elevenlabs/elevenlabs-scribe-v2 erfasst jedes Wort zeitlich, und seine Untertitel werden in Zeilen von höchstens 42 Zeichen geschnitten, eine neue nach jedem Satz. Wenn ein Modell keine Zeitangaben für eine Aufnahme sendet, antworten srt, vtt und verbose_json mit 400 timestamps_unavailable und es wird nichts berechnet. Die Abrechnung erfolgt pro Minute Audio, unabhängig vom Format. Dateien können bis zu 40 MB groß sein. Das Format (mp3, wav, ogg, flac, m4a/mp4, webm, aac) wird aus der Aufnahme selbst gelesen, nicht aus ihrem Dateinamen, sodass ein Upload namens tmp123.out funktioniert.

Mit dem OpenAI SDK

from openai import OpenAI

client = OpenAI(base_url="https://api.martllm.com/v1", api_key="<your MartLLM key>")

speech = client.audio.speech.create(model="x-ai/tts-xai-v1", voice="eve", input="Hello from MartLLM.")
speech.write_to_file("speech.mp3")

with open("speech.mp3", "rb") as f:
    text = client.audio.transcriptions.create(model="venice/whisper-large-v3", file=f)
print(text.text)

Was Sie bezahlen

  • Der Preis dessen, was erstellt wurde: was der Anbieter berechnet hat, ohne MartLLM-Gebühr. Eine Bild- oder Transkriptionsantwort und ein abgeschlossener Auftrag weisen ihn als usage.cost_usd (US-Dollar) aus; jede Antwort, die etwas erstellt hat, weist ihn auch im X-UberLLM-Cost-USD Antwort-Header aus (bei Sprache ist der Header der einzige Ort, da die Antwort die Audiodatei ist). Er wird unter Dashboard → Activity angezeigt. Der Rest des einbehaltenen Betrags wird zurückerstattet.
  • Nichts für einen Auftrag, der failed, canceled oder expired war, oder für eine Bild-, Sprach- oder Transkriptionsanfrage, die fehlschlägt.
  • Der günstigste Anbieter, der genau das erstellt, was Sie angefordert haben. Viele Bild- und Videomodelle haben mehr als einen Anbieter; jede Anfrage geht an den günstigsten, der sie mit Ihren Einstellungen erstellen kann, und an einen anderen, falls dieser sie nicht annehmen kann. Die Modellliste und jede Modellseite zeigen den Preis beim aktuell günstigsten Anbieter.
  • Die Routing-Einstellung Ihres Schlüssels (Dashboard → API keys) wählt zwischen Anbietern, wenn einer schneller ist: Günstigster Preis nimmt immer den günstigsten, die Standardeinstellung nimmt ebenfalls den günstigsten, es sei denn, er schlägt ständig fehl oder ist mehr als doppelt so langsam wie der schnellste, Ausgewogen nimmt den günstigsten, der höchstens 20% langsamer ist als der schnellste, und Schnellster nimmt den schnellsten, bis zum gelisteten Preis des Modells. Ein Kostenvoranschlag und der estimated_cost_usd des Auftrags zeigen den Preis des Anbieters, den Ihre Einstellung wählt. Siehe Routing-Einstellung Ihres Schlüssels.
  • Sehen Sie Ihr Guthaben und was mit GET /v1/balance (unten) einbehalten wird.

Preis prüfen, bevor Sie ausgeben

Fügen Sie "validate": true zu jeder Bild-, Video-, Musik- oder Sprachanfrage hinzu (für eine Transkription senden Sie validate=true als Formularfeld mit der Aufnahme). Die Anfrage wird geprüft, als wäre sie echt (Modell, Optionen, Quellbilder), nichts wird erstellt und nichts berechnet, und HTTP 200 gibt an, was es zum gelisteten Preis kostet (cost_usd, der auf der Modellseite angezeigte Preis; Sie zahlen, was der Anbieter berechnet hat, was abweichen kann) und was während der Ausführung einbehalten wird (max_cost_usd, der Höchstbetrag, der abgerechnet wird):

{ "object": "quote", "model": "bytedance/seedance-2-0-image-to-video", "kind": "video",
  "valid": true, "cost_usd": 0.2117, "max_cost_usd": 0.4235, "unit": "second", "units": 5, "duration_seconds": 5,
  "note": "Nothing was charged. …" }

Wenn der Anbieter des Modells eine Einstellung benötigt, die Sie weggelassen haben (ein Referenz-zu-Video-Modell benötigt aspect_ratio), wird der Standardwert, mit dem es gesendet wird, im Schema des Modells und im Kostenvoranschlag als defaults_applied angezeigt, z.B. "defaults_applied": {"aspect_ratio": "16:9"}.

Eine Anfrage, die abgelehnt würde, wird auf die gleiche Weise abgelehnt, mit Angabe des Grundes.

Preis für 15 Minuten halten

POST /v1/quote nimmt denselben Body wie die Bild-, Video-, Musik- oder Sprachanfrage und antwortet mit den gelisteten Kosten (cost_usd), dem Betrag, der während der Ausführung einbehalten wird (max_cost_usd, der Höchstbetrag, der abgerechnet wird) und einem quote_id (für eine Transkription senden Sie model und duration_seconds; eine Transkription selbst benötigt kein quote_id, verwenden Sie max_cost, um sie zu begrenzen):

curl https://api.martllm.com/v1/quote \
  -H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
  -d '{"model": "kling/kling-o3", "prompt": "a red ball bouncing", "duration_seconds": 5}'
{ "object": "quote", "id": "6f1c…", "quote_id": "6f1c…", "model": "kling/kling-o3",
  "kind": "video", "cost_usd": 0.225, "max_cost_usd": 0.495, "unit": "job", "units": 1,
  "expires_at": 1792541700, "note": "Nothing was charged. …" }

Senden Sie dieselbe Anfrage mit "quote_id": "6f1c…" innerhalb von 15 Minuten, und es wird Ihnen berechnet, was der Anbieter in Rechnung gestellt hat, höchstens max_cost_usd; wenn der Betrag, der beim Start einbehalten werden muss, über max_cost_usd liegt, wird er kostenlos storniert. Für den Kostenvoranschlag selbst wird nichts berechnet oder einbehalten.

  • Ein Kostenvoranschlag startet eine Anfrage. Die erneute Verwendung antwortet 409 quote_used; ein Auftrag, der nie ein Modell erreicht hat, gibt den Kostenvoranschlag zurück.
  • Die Anfrage muss dasselbe verlangen: dasselbe Modell und dieselben Einstellungen (Prompt, Größe, Clip-Länge, Quellbilder …). Alles andere wird mit 400 quote_mismatch abgelehnt. max_cost, metadata und output_upload_url können abweichen.
  • Nach 15 Minuten antwortet es 400 quote_expired. Chat-Modelle werden pro token abgerechnet und haben keinen Kostenvoranschlag: begrenzen Sie sie mit provider.max_price.

Fallback-Modelle und eine Preisobergrenze

"models": ["model-b", "model-c"] benennt Modelle, die der Reihe nach versucht werden, wenn das erste gerade nicht bedient werden kann (no_available_provider) oder über Ihrem provider.max_price liegt. Jede andere Ablehnung wird sofort beantwortet. Der model der Antwort benennt das Modell, das sie erstellt hat (eine Sprachantwort ist die Audiodatei selbst: Activity zeigt ihr Modell). Eine Anfrage mit quote_id benötigt kein models, und eine Transkription benötigt beides nicht.

"provider": {"max_price": 0.05} ist der Höchstbetrag, den eine Einheit (die Preisgestaltung des Modells unit: Bild, Sekunde, Megapixel, Minute, 1K Zeichen oder Anfrage) in US-Dollar kosten darf. Ein Modell, das darüber liegt, wird mit 400 max_price_exceeded abgelehnt, und die Anfrage wird niemals über max_price mal ihren Einheiten abgerechnet. Andere provider Optionen werden mit 400 unsupported_routing_option abgelehnt, da die Anbieterwahl für Medienanfragen nicht pro Anfrage gesteuert werden kann.

"model": "best-price:image" (oder image-edit, text-to-video, image-to-video, music, speech, transcription) wählt das günstigste verfügbare Modell für den Auftrag; fastest: das schnellste gemessene. Siehe Modell-Aliase.

Tags

"metadata": {"project": "spring-ads"} (bis zu 16 Textwerte) wird mit dem Auftrag gespeichert, in dessen Status zurückgegeben, in der Activity und im CSV-Export angezeigt und niemals an ein Modell gesendet. Bei einer Transkription senden Sie sie als Formularfelder: -F "metadata[project]=spring-ads". Siehe Tags.

Eine Obergrenze festlegen

Senden Sie "max_cost" (US-Dollar, z.B. 0.50) mit jeder Bild-, Video-, Musik- oder Sprachanfrage (ein Formularfeld bei einer Transkription). Wenn es mehr kosten kann, wird es mit 400 max_cost_too_low abgelehnt und nichts berechnet. Bei einem Video- oder Musikauftrag wird die genaue Obergrenze beim Start des Auftrags festgelegt; wenn sie dann über Ihrem max_cost liegt, wird der Auftrag kostenlos storniert. Mit "validate": true fügt der Kostenvoranschlag within_max_cost hinzu.

Erneut versuchen, ohne doppelt zu bezahlen

Senden Sie einen Idempotency-Key Header (eine beliebige eindeutige Zeichenfolge von bis zu 255 Zeichen, wie z.B. eine UUID), wenn Sie einen Video- oder Musikauftrag starten. Wenn Ihre Verbindung abbricht und Sie dieselbe Anfrage mit demselben Schlüssel innerhalb von 24 Stunden erneut senden, erhalten Sie denselben Auftrag zurück anstelle eines zweiten. Derselbe Schlüssel mit einer anderen Anfrage wird mit 409 idempotency_key_reused abgelehnt. Bild-, Sprach- und Transkriptionsanfragen benötigen keinen Schlüssel: eine fehlgeschlagene wurde nicht berechnet, senden Sie sie also erneut.

Ihr Guthaben

curl -H "Authorization: Bearer $UBERLLM_API_KEY" https://api.martllm.com/v1/balance
{ "balance_usd": 12.40, "held_usd": 0.35, "available_usd": 12.05 }

held_usd ist für noch laufende Anfragen vorgemerkt; es kommt (abzüglich der tatsächlichen Kosten) zurück, wenn sie beendet sind. available_usd steht neuen Anfragen zur Verfügung.

Optionen jedes Modells

GET /v1/models?type=image (oder video, music, speech, transcription, audio für beide davon, chat, all; mehrere durch Kommas getrennt; ohne type listet nur Chat-Modelle auf) listet die Modelle auf, die Sie jetzt aufrufen können, jedes mit seinem type, dem endpoints, an das es gesendet werden soll, und seinem pricing. GET /v1/models/<model id> gibt ein Modell aus, und für ein Medienmodell ein parameters-Objekt: ein JSON-Schema des Anfragetextes mit den unterstützten Clip-Längen, Auflösungen, Seitenverhältnissen und Größen, und welches Quellbild es benötigt.

curl -H "Authorization: Bearer $UBERLLM_API_KEY" \
  https://api.martllm.com/v1/models/pixverse/pixverse-c1-reference-to-video

pricing hat usd (der höchste Preis, den ein unit jetzt kostet) und list_usd (der eigene Preis des Modellherstellers); ein Chat-Modell hat input_usd, output_usd und deren list_-Preise pro 1M tokens.

usd ist der Preis, der für eine einfache Anfrage an das Modell jetzt angegeben wird: der Anbieter, an den Ihre Anfrage mit einem auf Balanced (Standard) eingestellten Schlüssel gehen würde, inklusive unserer Gebühr. Die Listen und das Angebot werden vom selben Code erstellt und folgen unseren Anbietern innerhalb von etwa 30 Sekunden (ein Anbieter pausiert, abgeschaltet oder neu bepreist).

Ein Modell, dessen Preis nach Auflösung berechnet wird, hat auch resolutions: eine Zeile pro Auflösung (ein Video mit 480p / 720p / 1080p, ein Bild mit 1K / 2K / 4K), günstigste zuerst, jeweils mit usd (was eine Sekunde oder ein Bild in dieser Auflösung kostet) und list_usd. usd oben ist die günstigste Zeile. Ein Clip wird zum Preis der angefragten Auflösung multipliziert mit seiner Dauer in Sekunden abgerechnet:

"pricing": {"usd": 0.100884, "unit": "second", "resolutions": [
  {"resolution": "480p", "usd": 0.100884, "list_usd": 0.1287},
  {"resolution": "720p", "usd": 0.2268, "list_usd": 0.289},
  {"resolution": "1080p", "usd": 0.56133, "list_usd": 0.7107}]}

Einige Anbieter berechnen einen ganzen Clip, nicht pro Sekunde. Eine solche Zeile hat auch seconds: die Clip-Länge, für die sein usd der Preis pro Sekunde ist. Dies ist der höchste Tarif (der kürzeste Clip des Modells), daher kostet ein längerer Clip weniger als usd mal seine Sekunden, und eine Anfrage, die keine Länge angibt, wird genau usd mal seconds berechnet. seconds erscheint auch, wenn eine Auflösung nur in einer Länge verkauft wird.

{"resolution": "720p", "usd": 0.062344, "list_usd": 0.075, "seconds": 4}

Ein Preis pro Sekunde wird auf die nächste $0.000001 gerundet. Für den genauen Preis einer Anfrage fordern Sie ein Angebot an ("validate": true).

Fehler

HTTP Code Bedeutung
400 wrong_endpoint z.B. ein Bildmodell, das an /v1/video/generations gesendet wurde, ein Chatmodell, das an eine Bildroute gesendet wurde, oder ein Sprachmodell, das an /v1/audio/transcriptions gesendet wurde; die Nachricht nennt den richtigen Pfad. Es wird nichts berechnet, und die Aktivität listet es als abgelehnt auf
400 invalid_request die Anfrage ist falsch (die Nachricht sagt, warum, z.B. eine Dauer, die das Modell nicht anbietet, oder ein fehlendes Quellbild)
400 image_required eine Bearbeitung oder ein Bild-zu-Video- oder Referenz-zu-Video-Modell ohne Quellbild
400 max_cost_too_low es kann mehr kosten als Ihre max_cost; es wurde nichts berechnet
400 timestamps_unavailable srt, vtt oder verbose_json von einem Transkriptionsmodell angefordert, das keine Zeitangaben gesendet hat; es wurde nichts berechnet
409 idempotency_key_reused dass Idempotency-Key für eine andere Anfrage verwendet wurde
400 quote_mismatch / quote_expired die Anfrage ist nicht die zitierte, oder das Angebot ist älter als 15 Minuten
404 quote_not_found kein solches Angebot in Ihrem Konto
409 quote_used dieses Angebot hat bereits eine Anfrage gestartet
400 max_price_exceeded das Modell kostet pro Einheit mehr als Ihre provider.max_price
400 unsupported_routing_option eine provider-Option außer max_price
404 file_not_found keine solche hochgeladene Datei in Ihrem Konto, oder sie ist abgelaufen
413 file_too_large ein Upload über 10 MB
429 too_many_files 500 Uploads werden bereits gespeichert; löschen Sie einige oder warten Sie, bis sie ablaufen
503 files_unavailable Uploads sind derzeit nicht verfügbar
413 request_too_large die Anfrage überschreitet das Größenlimit (40 MB); senden Sie Bilder als https://-Links und teilen Sie lange Aufnahmen auf
402 insufficient_credits Ihr Guthaben kann die maximalen Kosten des Auftrags nicht decken; die Nachricht sagt, wie viel benötigt wird
404 model_not_found / not_found kein solches Modell oder kein solcher Auftrag in Ihrem Konto
404 artifact_expired die Datei wird nicht mehr gespeichert (siehe oben)
429 rate_limited warten Sie die Sekunden in Retry-After (einige Sekunden, falls nicht vorhanden), versuchen Sie es dann erneut; X-RateLimit-Remaining zeigt an, wie viele Anfragen in dieser Minute noch übrig sind
503 no_available_provider kein Anbieter kann es derzeit erstellen; MartLLM hat die anderen bereits versucht. Die Nachricht nennt die Modelle derselben Art, die jetzt funktionieren