> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexinference.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Schnellstart

> Von null zu Ihrer ersten Anfrage, die den günstigeren flex-Tier nutzt und trotzdem pünktlich zurückkommt.

Senden Sie eine Anfrage über FlexInference mit Ihrem bestehenden Provider-Schlüssel. Richten Sie Ihren OpenAI-kompatiblen Client auf FlexInference aus, fügen Sie `start_within` hinzu, und FlexInference versucht zuerst den günstigeren flex-Tier, bevor es auf den standard-Tier eskaliert. Es funktioniert mit OpenAI, Gemini und Anthropic, und Sie können eine [Cloud-Route](/de/models) festlegen, um dasselbe Modell über Amazon Bedrock oder Google Vertex AI bereitzustellen. Bei einer flex-Anfrage berechnet FlexInference 20 % der Einsparungen und nichts, wenn keine Einsparungen erzielt werden.

## Voraussetzungen

* Ein [OpenAI API-Schlüssel](https://platform.openai.com/api-keys) mit verfügbarem Guthaben. FlexInference verwendet Ihren Schlüssel als BYOK, und OpenAI stellt Ihnen die Kosten direkt in Rechnung.
* Ein Terminal mit `curl`, oder Python 3.9+, oder Node.js 18+.

## Erste Schritte

<Steps>
  <Step title="FlexInference-Konto erstellen">
    Gehen Sie zum [Dashboard](https://www.flexinference.com/dashboard) und melden Sie sich an. Ihr Konto ist eine eigene Organisation. Es verwaltet Ihre API-Schlüssel und verfolgt die Nutzung, wodurch Ihre Schlüssel und Rechnungen von anderen Organisationen getrennt bleiben.
  </Step>

  <Step title="API-Schlüssel erstellen">
    Erstellen Sie im Dashboard einen Schlüssel. Er beginnt mit `flex_live_...` und wird nur einmal angezeigt. Speichern Sie ihn jetzt. Senden Sie diesen Schlüssel an FlexInference anstelle Ihres OpenAI-Schlüssels.
  </Step>

  <Step title="OpenAI-Schlüssel hinzufügen (BYOK)">
    Fügen Sie Ihren OpenAI-Schlüssel in das Dashboard ein. FlexInference speichert ihn verschlüsselt und verwendet ihn nur für Anfragen, die in Ihrem Namen gestellt werden; Sie senden ihn nicht pro Anfrage. Details finden Sie unter [Authentifizierung](/de/authentication).
  </Step>

  <Step title="Ihre erste Anfrage stellen">
    Richten Sie Ihren Client auf `https://api.flexinference.com/v1` aus und fügen Sie `start_within` hinzu. Hier bedeutet `00h-00m-30s`, dass die Anfrage bis zu 30 Sekunden warten kann, bevor sie startet. FlexInference versucht zuerst den flex-Tier von OpenAI, da dieser weniger kostet, aber in einer Warteschlange landen kann. Wenn flex nicht innerhalb von 30 Sekunden startet, führt FlexInference stattdessen den normalen standard-Tier aus. Standard ist der Tier zum vollen Preis und startet sofort.

    Flex ist der günstigere Tier und kann vor dem Start in einer Warteschlange warten. Standard ist der normale Tier zum vollen Preis und startet sofort. FlexInference bewegt sich preislich nach oben, nicht qualitativ nach unten: Es beginnt mit flex und verwendet standard nur, wenn flex Ihr Zeitlimit überschreiten würde.

    `start_within` ist die maximale Wartezeit, bevor die Anfrage startet. Geben Sie es als Dauer an, z. B. `00h-00m-30s` für 30 Sekunden. Ein größerer Wert gibt flex mehr Zeit zum Starten, was mehr Geld sparen kann. Ein kleinerer Wert verschiebt die Anfrage früher auf standard. Das Claude-Beispiel übergibt `default` anstelle einer Dauer, da Anthropic keinen flex-Tier hat, mit dem es konkurrieren könnte, sodass die Anfrage direkt an standard geht. Der Wert begrenzt die Startzeit, nicht die gesamte Generierungszeit. Eine vollständige Liste der Werte finden Sie auf der Routing-Seite.

    <CodeGroup>
      ```bash curl theme={null}
      curl https://api.flexinference.com/v1/responses \
        -H "Authorization: Bearer $FLEX_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "gpt-5-nano",
          "input": "Write a haiku about cheap GPUs.",
          "start_within": "00h-00m-30s"
        }'
      ```

      ```python Python (openai SDK) theme={null}
      from openai import OpenAI

      client = OpenAI(
          base_url="https://api.flexinference.com/v1",
          api_key="flex_live_...",  # your FlexInference key
      )

      resp = client.responses.create(
          model="gpt-5-nano",
          input="Write a haiku about cheap GPUs.",
          extra_body={"start_within": "00h-00m-30s"},
      )
      print(resp.output_text)
      ```

      ```typescript Node (openai SDK) theme={null}
      import OpenAI from "openai";

      const client = new OpenAI({
        baseURL: "https://api.flexinference.com/v1",
        apiKey: "flex_live_...", // your FlexInference key
      });

      const resp = await client.responses.create({
        model: "gpt-5-nano",
        input: "Write a haiku about cheap GPUs.",
        // start_within is a FlexInference extension; cast to pass it through.
        start_within: "00h-00m-30s",
      } as any);

      console.log(resp.output_text);
      ```

      ```bash curl (Gemini, Interactions) theme={null}
      curl https://api.flexinference.com/v1/interactions \
        -H "Authorization: Bearer $FLEX_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "gemini-3.5-flash",
          "input": "Write a haiku about cheap GPUs.",
          "start_within": "00h-00m-30s"
        }'
      ```

      ```bash curl (Claude, Messages) theme={null}
      curl https://api.flexinference.com/v1/messages \
        -H "Authorization: Bearer $FLEX_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "claude-opus-4-8",
          "max_tokens": 1024,
          "messages": [{ "role": "user", "content": "Write a haiku about cheap GPUs." }],
          "start_within": "default"
        }'
      ```
    </CodeGroup>
  </Step>
</Steps>

<Check>
  Eine `200`-Antwort mit `"service_tier": "flex"` bedeutet, dass flex rechtzeitig gestartet ist und
  bei diesem Aufruf Geld gespart wurde. `"service_tier": "default"` bedeutet, dass FlexInference
  standard verwendet hat, weil flex Ihr Zeitlimit überschritten hätte. Die Antwort-Header
  `x-flexinference-flex-applied` und `x-flexinference-flex-reason` zeigen das
  gleiche Ergebnis für den Code an. In jedem Fall wird die Anfrage pünktlich abgeschlossen.
</Check>

<Note>
  Wenn Ihre erste Anfrage fehlschlägt, lesen Sie den Fehlertext. FlexInference-Fehler geben an,
  was schiefgelaufen ist, warum es passiert ist, wie es behoben werden kann, und enthalten ein
  funktionierendes Beispiel. Wenn Sie Ihren OpenAI-Schlüssel nicht im Dashboard hinzugefügt haben,
  besagt der Fehler dies und verweist auf die Seite, die das Problem behebt. Provider-Fehler
  werden mit ihrem ursprünglichen Status und Text weitergeleitet. Eine vollständige Liste finden
  Sie auf der Fehlerseite.
</Note>

## Was Sie als Nächstes ausprobieren können

<CardGroup cols={2}>
  <Card title="Ihr Zeitlimit festlegen" icon="hourglass-half" href="/de/deadline-routing">
    Erfahren Sie mehr über die `start_within`-Werte und die Regel, die Anfragen von flex
    zu standard verschiebt.
  </Card>

  <Card title="Streaming, Tools, Vision" icon="code" href="/de/sdks">
    Nutzen Sie Streaming, Tools und Vision über OpenAI, Gemini und Anthropic hinweg.
  </Card>
</CardGroup>