Points de terminaison de l’API Tokios : référence OpenAI et Anthropic

Toutes les requêtes API de Tokios sont envoyées à https://api.tokios.com en utilisant votre clé API sk-tok-... en tant que jeton Bearer. Tokios propose les fonctionnalités Chat Completions d’OpenAI, Responses d’OpenAI et Messages d’Anthropic, ainsi que la liste des modèles et le décompte des jetons.

Base URL

https://api.tokios.com

Essayer en direct — testez n’importe quel modèle enregistré sur console Playground sans écrire de code. Cette opération se déroule dans votre session connectée, il n’est donc pas nécessaire d’utiliser de clé API pour expérimenter.

Authentification

Chaque requête doit comporter ces en-têtes :

Authorization: Bearer sk-tok-YOUR_KEY
Content-Type: application/json

Le champ model dans chaque requête correspond au nom de déploiement public que vous avez enregistré (par exemple gemma-tunnel), et non à l’ID de modèle local.

Exemples d’utilisation

POST/v1/chat/completionsOpenAI dialect

Formats de requêtes courants à adresser à /v1/chat/completions. Remplacez sk-tok-YOUR_KEY et gemma-tunnel par vos propres valeurs. Le streaming et l’appel d’outils dépendent de la prise en charge par le modèle sous-jacent.

Cas de base
Streaming
Appel de outils
Windows

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "What is 2 + 2?"}]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

resp = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "What is 2 + 2?"}],
)
print(resp.choices[0].message.content)

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Write a haiku about tunnels."}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

stream = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Write a haiku about tunnels."}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "What is the weather in Paris?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

resp = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "What is the weather in Paris?"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

PowerShell lit -d @body.json depuis un fichier afin d’éviter les complications liées à l’échappement des guillemets :

PowerShell

$body = '{"model":"gemma-tunnel","messages":[{"role":"user","content":"What is 2 + 2?"}]}'
Set-Content -Path body.json -Value $body -Encoding ascii
curl.exe https://api.tokios.com/v1/chat/completions `
  -H "Authorization: Bearer sk-tok-YOUR_KEY" `
  -H "Content-Type: application/json" `
  -d "@body.json"

POST/v1/chat/completionsOpenAI dialect

POST /v1/chat/completions

Ce procédé fonctionne avec les SDK OpenAI pris en charge. Envoyez une liste de messages puis recevez une réponse issue du modèle que vous avez enregistré.

Corps de la requête

string

requis

Nom du déploiement public (par exemple "gemma-tunnel").

array

requis

Tableau d’objets messages. Chacun comporte un role ("system", "user" ou "assistant") ainsi qu’un content. Le contenu peut être une chaîne de caractères ou un tableau de blocs de contenu (texte, appels d’outils, images) ; Tokios transmet cette structure telle quelle.

boolean

défaut:"false"

Transmettez la réponse en continu via les événements envoyés par le serveur.

number

Température d’échantillonnage. Des valeurs plus élevées génèrent des résultats plus aléatoires.

integer

Nombre maximal de jetons à générer.

Example request

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is 2 + 2?"}
    ]
  }'

Response · 200

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1717000000,
  "model": "gemma-tunnel",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "2 + 2 equals 4." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 9, "total_tokens": 33 }
}

POST/v1/messagesAnthropic dialect

POST /v1/messages

Ce connecteur fonctionne avec les SDK Anthropic pris en charge. Envoyez un tableau de messages et recevez une réponse au format Anthropic. Tokios convertit ensuite cette réponse en format Chat Completions pour votre modèle, puis la retransforme en retour.

Corps de la requête

string

requis

Nom du déploiement public.

array

requis

Tableau d’objets messages contenant un role ("user" ou "assistant") ainsi qu’un content (chaîne de caractères ou tableau de blocs de contenu).

integer

requis

Nombre maximal de jetons à générer.

string

Prompt système à ajouter au début de la conversation.

boolean

défaut:"false"

Permet de diffuser la réponse via des événements envoyés par le serveur.

Example request

curl https://api.tokios.com/v1/messages \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Explain async/await"}]
  }'

Response · 200

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "Async/await is a syntax for handling asynchronous operations..." }],
  "model": "gemma-tunnel",
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 12, "output_tokens": 48 }
}

POST/v1/messages/count_tokensAnthropic dialect

POST /v1/messages/count_tokens

Ce connecteur fonctionne également avec les SDK Anthropic pris en charge. Envoyez le même format de corps de requête que pour /v1/messages afin d’obtenir le nombre de jetons d’entrée sans exécuter de complétion.

Example request

curl https://api.tokios.com/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Explain async/await"}]
  }'

Response · 200

{ "input_tokens": 12 }

POST/v1/responsesOpenAI dialect

POST /v1/responses

Ce connecteur fonctionne avec les SDK OpenAI pris en charge utilisant le nouveau format Responses (celui employé par OpenAI Codex). Tokios le traduit en format Chat Completions pour votre modèle.

Corps de la requête

string

requis

Le nom du déploiement public.

string | array

requis

Le texte d’entrée, ou un tableau d’éléments d’entrée, servant à générer une réponse.

boolean

défaut:"false"

Transmettez la réponse en continu via les événements envoyés par le serveur.

Example request

curl https://api.tokios.com/v1/responses \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "input": "Write a haiku about tunnels."
  }'

GET/v1/modelsOpenAI dialect

GET /v1/models

Cette requête liste les déploiements de modèles accessibles via votre clé API. Elle fonctionne avec les SDK OpenAI pris en charge, en respectant la structure de liste standard.

Example request

curl https://api.tokios.com/v1/models \
  -H "Authorization: Bearer sk-tok-YOUR_KEY"

Response · 200

{
  "object": "list",
  "data": [
    { "id": "gemma-tunnel", "object": "model", "owned_by": "tokios" },
    { "id": "qwen-coder", "object": "model", "owned_by": "tokios" }
  ]
}

Le sélecteur de modèles de Claude Code ne présente que les ID de type claude*, donc il n’affichera pas vos modèles Tokios. Indiquez le modèle explicitement via claude --model gemma-tunnel — consultez le guide Claude Code.

Codes d’erreur

Statut HTTP	Signification
400	Corps de requête mal formé
401	Clé API manquante ou non valide
403	La clé API ne dispose pas des autorisations nécessaires pour utiliser ce modèle, ou le compte est suspendu
404	Aucun déploiement de modèle n’a été trouvé
503	Le connecteur est hors ligne ou à pleine capacité (`connector_unavailable` / `connector_busy`)

Le statut 503 indique que le connecteur associé à ce déploiement n’est pas actuellement connecté (ou qu’il a atteint sa limite de concurrence). Lancez le connecteur et vérifiez qu’il apparaît en ligne dans le tableau de bord avant de réessayer.

Premiers pas

Modèles

Concepts

Référence

Points de terminaison de l’API Tokios : référence OpenAI et Anthropic

Authentification

Exemples d’utilisation

POST /v1/chat/completions

Corps de la requête

POST /v1/messages

Corps de la requête

POST /v1/messages/count_tokens

POST /v1/responses

Corps de la requête

GET /v1/models

Codes d’erreur

​Authentification

​Exemples d’utilisation

​POST /v1/chat/completions

​Corps de la requête

​POST /v1/messages

​Corps de la requête

​POST /v1/messages/count_tokens

​POST /v1/responses

​Corps de la requête

​GET /v1/models

​Codes d’erreur

Authentification

Exemples d’utilisation

POST /v1/chat/completions

Corps de la requête

POST /v1/messages

Corps de la requête

POST /v1/messages/count_tokens

POST /v1/responses

Corps de la requête

GET /v1/models

Codes d’erreur