API-Referenz/Modelle und Preise

Modelle und Preise

Mit diesen Endpunkten rufst du die Modelle ab, die du gerade aufrufen kannst – samt Kontextlänge, Fähigkeiten und Preisen –, statt eine Modelltabelle von Hand zu pflegen.

Diese Endpunkte sind öffentlich: Ein API-Key ist nicht nötig, und sie liefern nur Modelle, die du gerade aufrufen kannst. Sende die Anfragen an den API-Host, also an dieselbe Base URL wie deine Modellaufrufe.

Auf dieser Seiteexpand_more

Modellliste
Preiskatalog
Bild- und Videomodelle

Modelllistelink

Eine OpenAI-kompatible Modellliste. Standardmäßig enthält sie nur Textmodelle, damit Clients, die jeden Eintrag als Chat-Modell behandeln, ohne Anpassung funktionieren.

GET/v1/models

cURL

curl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'

Query-Parameter

output_modalities: Optional. Filtert nach Ausgabetyp: text, image, video, all oder eine kommagetrennte Kombination wie text,image. Standard ist text. Ein ungültiger Wert liefert 400 invalid_output_modalities.

Antwortfelder

id: Die Modell-ID, die du als model sendest.
owned_by: Der Hauptanbieter des Modells. Hat ein Modell mehrere Anbieter, steht die vollständige Liste im Preiskatalog unter providers.
name: Anzeigename.
context_length: Kontextfenster in Token. Nur bei Textmodellen.
max_completion_tokens: Maximale Zahl der Ausgabe-Token pro Anfrage. Nur bei Textmodellen.
architecture: input_modalities und output_modalities sind die Eingabe- und Ausgabetypen, die das Modell unterstützt, und sind maßgeblich; modality ist ein daraus zusammengesetzter Anzeigetext.
pricing: Preise von Textmodellen in USD pro Token, als Dezimalstrings. prompt ist die Eingabe, completion die Ausgabe, input_cache_read, input_cache_write und input_cache_write_1h stehen für Cache-Lesen und Cache-Schreiben; Einträge, die ein Modell nicht unterstützt, fehlen.
supported_parameters: Fähigkeiten, die das Modell nachweislich unterstützt, zum Beispiel max_tokens und tools.

JSON

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4.1-flash",
      "owned_by": "deepseek",
      "object": "model",
      "created": 0,
      "name": "DeepSeek-V4.1-Flash",
      "context_length": 1000000,
      "max_completion_tokens": 393216,
      "architecture": {
        "modality": "text+image->text",
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"]
      },
      "pricing": {
        "prompt": "0.000000075",
        "completion": "0.0000003",
        "input_cache_read": "0.0000000015"
      },
      "supported_parameters": ["max_tokens", "tools"]
    }
  ]
}

Das Beispiel zeigt nur ein Modell und lässt einige Felder weg.

/models und /v1/models liefern denselben Inhalt.
Antworten enthalten einen ETag. Sende If-None-Match mit: Bei unveränderter Liste kommt 304 zurück, Polling kostet also kaum etwas.
Ein vorübergehend ausgelastetes Modell bleibt in der Liste; Aufrufe liefern 429, bis wieder Kapazität frei ist.

Preiskataloglink

Preise aller Modelle, die du gerade aufrufen kannst, in einem einheitlichen Format für Text, Bild und Video. Anders als die Modellliste liefert der Endpunkt standardmäßig alle Typen.

GET/v1/models/pricing

cURL

curl 'https://api.wokey.ai/v1/models/pricing?model=deepseek-v4.1-flash'
curl 'https://api.wokey.ai/v1/models/pricing?output_modalities=image,video'

Query-Parameter

output_modalities: Optional. Dieselben Werte wie bei der Modellliste; Standard ist all.
model: Optional. Liefert nur ein Modell, ohne Beachtung der Groß- und Kleinschreibung. Eine unbekannte Modell-ID liefert eine leere Liste.

Antwortfelder

owned_by / providers: owned_by ist der Hauptanbieter; providers listet die derzeit aktiven Anbieter in der Standardpriorität auf, mit den Anbieter-IDs, die der Request-Parameter provider akzeptiert. Der Preis ist derselbe, egal welcher Anbieter die Anfrage bedient.
pricing_skus: Die Liste der Preiseinträge, für jedes Modell im selben Format.
pricing_skus[].meter: Was abgerechnet wird. Textmodelle nutzen input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cache_write_5m_tokens und cache_write_1h_tokens; Bilder output_images; Videos output_video.
pricing_skus[].unit / quantity: Einheit und Menge, auf die sich der Preis bezieht: pro 1.000.000 Token bei Text, pro Bild und pro Sekunde Video.
pricing_skus[].price_usd: Der Wokey-Preis in USD, als Dezimalstring.
reference_price_usd / savings_pct: Nur bei Textmodellen: der offizielle Referenzpreis und die Ersparnis gegenüber diesem Preis in Prozent.
pricing_skus[].constraints: Wann der Preis gilt, zum Beispiel eine Größenstufe bei Bildern oder Modus, Auflösung und Dauerbereich bei Videos.
time_of_day: Nur bei Modellen mit tageszeitabhängigem Preis. current_tier ist der aktuelle Zeitraum (peak oder off_peak), peak_windows_utc nennt die Spitzenzeiten in UTC, tiers enthält die Preise beider Zeiträume. pricing_skus zeigen immer den aktuellen Zeitraum.
prompt_tiers: Nur bei Modellen mit Preisstufen nach Eingabelänge. Überschreitet die Eingabe einer Anfrage (einschließlich Cache-Lesen und Cache-Schreiben) above_prompt_tokens, gelten für alle Abrechnungsposten die Preise dieser Stufe.

JSON

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4.1-flash",
      "name": "DeepSeek-V4.1-Flash",
      "owned_by": "deepseek",
      "providers": ["deepseek", "opencode", "ollama", "volcengine"],
      "object": "model",
      "available": true,
      "currency": "USD",
      "pricing_skus": [
        {
          "sku_id": "deepseek-v4.1-flash:input_tokens",
          "meter": "input_tokens",
          "unit": "token",
          "quantity": 1000000,
          "price_usd": "0.075000",
          "reference_price_usd": "0.150000",
          "savings_pct": "50"
        },
        {
          "sku_id": "deepseek-v4.1-flash:output_tokens",
          "meter": "output_tokens",
          "unit": "token",
          "quantity": 1000000,
          "price_usd": "0.300000",
          "reference_price_usd": "0.600000",
          "savings_pct": "50"
        }
      ]
    }
  ]
}

Das Beispiel zeigt nur ein Modell und lässt einige Felder weg.

Preise können sich je nach Tageszeit und Angebot ändern, deshalb wird dieser Endpunkt nie gecacht und liefert immer die aktuellen Preise.

Bild- und Videomodellelink

cURL

curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'

GET/v1/images/models

Liefert die Bildmodelle, die du gerade aufrufen kannst: unterstützte Endpunkte (Generierung, Bearbeitung), Parameter und zulässige Werte (parameter_schema), Unterstützung für Streaming und Bearbeitung sowie den Preis pro Bild (pricing_skus). Verwendung: Bildgenerierung →

GET/v1/videos/models

Liefert Videomodelle mit mindestens einer verkäuflichen Variante: Generierungsmodi, Auflösungen, Seitenverhältnisse, Dauerbereich, Limits für multimodale Referenzen sowie den Preis pro Sekunde jeder Variante (pricing_skus). Verwendung: Videogenerierung →