> ## 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.
# Démarrage rapide
> De zéro à votre première requête qui utilise le niveau le moins cher et revient toujours à temps.
Envoyez une requête via FlexInference avec votre clé de fournisseur existante. Pointez votre client compatible OpenAI vers FlexInference, ajoutez `start_within`, et FlexInference essaiera le niveau flex moins cher avant de passer au niveau standard. Cela fonctionne avec OpenAI, Gemini et Anthropic, et vous pouvez épingler une [route cloud](/fr/models) pour servir le même modèle via Amazon Bedrock ou Google Vertex AI. Pour une requête flex, FlexInference facture 20 % des économies réalisées, et ne facture rien s'il n'y a pas d'économies.
## Prérequis
* Une [clé API OpenAI](https://platform.openai.com/api-keys) avec un crédit disponible. FlexInference utilise votre clé comme BYOK, et OpenAI vous facture directement.
* Un terminal avec `curl`, ou Python 3.9+, ou Node.js 18+.
## Démarrer
Allez sur le [tableau de bord](https://www.flexinference.com/dashboard) et connectez-vous. Votre compte est sa propre organisation. Il possède vos clés API et suit l'utilisation, gardant vos clés et votre facture séparées des autres organisations.
Dans le tableau de bord, créez une clé. Elle commence par `flex_live_...` et n'apparaît qu'une seule fois. Stockez-la maintenant. Envoyez cette clé à FlexInference au lieu de votre clé OpenAI.
Collez votre clé OpenAI dans le tableau de bord. FlexInference la stocke chiffrée et ne l'utilise que pour les requêtes faites en votre nom ; vous ne l'envoyez pas par requête. Voir [Authentification](/fr/authentication) pour les détails.
Pointez votre client vers `https://api.flexinference.com/v1` et ajoutez `start_within`. Ici, `00h-00m-30s` signifie que la requête peut attendre jusqu'à 30 secondes pour démarrer. FlexInference essaie d'abord le niveau flex d'OpenAI car il coûte moins cher mais peut être mis en file d'attente. Si flex ne démarre pas dans les 30 secondes, FlexInference exécute le niveau standard normal à la place. Le niveau standard est le niveau à plein tarif et démarre immédiatement.
Flex est le niveau le moins cher, et il peut attendre dans une file d'attente avant de démarrer. Standard est le niveau normal à plein tarif, et il démarre immédiatement. FlexInference augmente le prix, pas la qualité : il commence par flex et n'utilise standard que si flex dépasse votre limite de temps.
`start_within` est le temps d'attente maximum avant le démarrage de la requête. Écrivez-le comme une durée, par exemple `00h-00m-30s` pour 30 secondes. Une valeur plus grande donne plus de temps à flex pour démarrer, ce qui peut économiser plus d'argent. Une valeur plus petite déplace la requête vers standard plus tôt. L'exemple Claude passe `default` au lieu d'une durée car Anthropic n'a pas de niveau flex à concurrencer, donc la requête va directement au niveau standard. La valeur borne le temps de démarrage, pas le temps de génération total. Voir la page de routage pour la liste complète des valeurs.
```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"
}'
```
Une réponse `200` avec `"service_tier": "flex"` signifie que flex a démarré à temps et
a permis d'économiser de l'argent sur cet appel. `"service_tier": "default"` signifie que FlexInference a utilisé
standard parce que flex aurait dépassé votre limite de temps. Les en-têtes de réponse
`x-flexinference-flex-applied` et `x-flexinference-flex-reason` exposent le
même résultat pour le code. Dans tous les cas, la requête se termine à temps.
Si votre première requête échoue, lisez le corps de l'erreur. Les erreurs FlexInference indiquent
ce qui n'a pas fonctionné, pourquoi cela s'est produit, comment le corriger, et incluent un
exemple fonctionnel. Si vous n'avez pas ajouté votre clé OpenAI dans le tableau de bord, l'erreur
le mentionne et pointe vers la page qui résout le problème. Les erreurs du fournisseur sont transmises
avec leur statut et leur corps d'origine. Voir la page des erreurs pour la liste complète.
## Que faire ensuite
Découvrez les valeurs de `start_within` et la règle qui déplace les requêtes de flex
vers standard.
Utilisez le streaming, les outils et la vision avec OpenAI, Gemini et Anthropic.