Zurelay Auto

Eén modelnaam, zurelay-auto, die elk verzoek laat beantwoorden door het model dat erbij past. Je betaalt de prijs van het model dat antwoordt, en het antwoord vermeldt welk model dat is. Het werkt overal waar je een model-ID kunt gebruiken, met dezelfde streaming, tools en redeneerniveaus.

import os
from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",
    api_key=os.environ["ZURELAY_API_KEY"],
)
response = client.chat.completions.create(
    model="zurelay-auto",
    messages=[
      {
        "role": "user",
        "content": "Summarize this in one sentence: Zurelay is one API for many models."
      }
    ],
)
print(response.choices[0].message.content)

Zo wordt het model gekozen

Auto bekijkt wat het verzoek bevat en kiest zonder zelf een model aan te roepen. Dat levert dus geen extra vertraging van kosten op. Elk verzoek komt in een van drie categorieën terecht:

Binnen de categorie kiest Auto het eerste model dat alle meegestuurde afbeeldingen, PDF's, audiofragmenten of video's kan lezen, waarvan het contextvenster ruimte biedt voor de prompt en de bijbehorende max_tokens, en dat een redeneerniveau ondersteunt als je dat instelt. Je reasoning_effort wordt uitgevoerd op het dichtstbijzijnde niveau dat het model ondersteunt.

De modellen waaruit Auto kiest

Elke categorie in de volgorde waarin Auto de modellen probeert, met hun prijzen per 1M input- en outputtokens. De lijst verandert zodra er betere van goedkopere modellen beschikbaar komen; je code hoeft niet mee te veranderen.

Wat je betaalt

Elk verzoek wordt afgerekend tegen de tarieven op Zurelay van het model dat het heeft beantwoord, zonder toeslag voor de keuze: momenteel van $0.025 tot $3.50 per 1M inputtokens en van $0.12 tot $17.50 per 1M outputtokens. Mislukte verzoeken zijn gratis, net als bij elk ander model (zie Facturering).

Welk model heeft geantwoord

Het veld model in het antwoord en de header x-zurelay-model vermelden welk model heeft geantwoord. x-zurelay-routed-from: zurelay-auto geeft aan dat Auto het heeft gekozen. Onder Verzoeken in het dashboard zie je hetzelfde.

HTTP/1.1 200 OK
x-zurelay-model: deepseek-v4.1-flash
x-zurelay-routed-from: zurelay-auto
{
  "model": "deepseek-v4.1-flash",
  "choices": [{ "message": { "role": "assistant", "content": "…" } }],
  …
}

Als een model niet kan antwoorden

Auto is gebouwd om antwoord te geven:

1. Het gekozen model herstelt zich net als elk model op Zurelay: het probeert het opnieuw en gebruikt daarna de reserveroutes van dat model.
2. Lukt het nog steeds niet, dan probeert Auto de overige modellen in de categorie van het verzoek, daarna de categorie erboven en vervolgens die eronder, tot maximaal vijf modellen in totaal.
3. Pas als ze allemaal mislukken, krijg je een 503 met model_unavailable en een retry-after-header.

Dit staat los van je instelling voor slimme routering: Auto doet dit altijd, en de header x-zurelay-fallback en de lijst models van een verzoek veranderen daar niets aan.

Anthropic-formaat

POST /v1/messages ondersteunt ook zurelay-auto. Daar kiest Auto uit Claude-modellen, die het Anthropic-formaat ondersteunen. Daardoor werken de Anthropic-SDK's en de daarop gebouwde tools net als bij elk ander Claude-model.

API-sleutels

Een sleutel die beperkt is tot zurelay-auto (zie sleutelregels) kan elk model gebruiken dat Auto kiest. Uitgavenlimieten en aanvraaglimieten gelden zoals gewoonlijk. De korte ID auto werkt ook.

Fouten

• 400 unsupported_content: geen van de modellen kan de meegestuurde media in combinatie lezen, zoals audio en een PDF in één verzoek. Verstuur ze apart of kies een model dat beide kan lezen.
• 400 context_length_exceeded: het verzoek is langer dan elk van de beschikbare modellen kan lezen. Stuur een korter verzoek of vraag om minder output.
• 503 model_unavailable: elk geprobeerd model is mislukt. Probeer het opnieuw na de wachttijd in de header retry-after.