Passer au contenu principal
Sunra fournit trois points de terminaison LLM API, chacun suivant un format différent. Les trois utilisent la même authentification et la même URL de base (https://api-llm.sunra.ai), vous pouvez donc choisir le format qui convient le mieux à votre stack technique. Avant de commencer, récupérez une clé API depuis votre tableau de bord.

Chat Completions — /v1/chat/completions

Le point de terminaison Chat Completions suit le format OpenAI Chat Completions. Il accepte une liste de messages avec des rôles (system, user, assistant) et renvoie une complétion. Utilisez ce point de terminaison lorsque vous souhaitez une compatibilité directe avec les SDK et les outils OpenAI. Fonctionnalités clés : streaming, appel de fonctions, vision (images, audio, vidéo, fichiers), raisonnement, sorties structurées (JSON schema / grammar), logprobs.
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'

Anthropic Messages — /v1/messages

Le point de terminaison Anthropic Messages suit le format Anthropic Messages API. Il utilise les rôles de message user / assistant avec des blocs de contenu riches et un paramètre system séparé. Utilisez ce point de terminaison lorsque vous souhaitez un accès natif aux modèles Anthropic Claude et aux fonctionnalités telles que la réflexion étendue, la mise en cache des prompts, les citations et les outils intégrés (recherche web, exécution de code). Fonctionnalités clés : streaming, réflexion étendue, mise en cache des prompts, utilisation d’outils (personnalisés + intégrés), entrée PDF/documents, citations, sorties structurées.
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, how are you?" }
    ]
  }'

Responses — /v1/responses

Le point de terminaison Responses suit le format OpenAI Responses API. Il accepte des éléments d’entrée flexibles (messages, appels de fonctions, raisonnement) et renvoie des éléments de sortie structurés. Utilisez ce point de terminaison lorsque vous avez besoin des dernières fonctionnalités OpenAI Responses comme la recherche web intégrée, la recherche de fichiers, l’interpréteur de code, l’utilisation de l’ordinateur, l’intégration d’outils MCP ou la génération d’images. Fonctionnalités clés : streaming, appel de fonctions, recherche web, recherche de fichiers, interpréteur de code, utilisation de l’ordinateur, outils MCP, génération d’images, raisonnement, sorties structurées.
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'

Choisir le bon point de terminaison

Chat CompletionsAnthropic MessagesResponses
FormatOpenAI ChatAnthropic MessagesOpenAI Responses
Idéal pourCompatibilité SDK OpenAIFonctionnalités natives ClaudeDernières fonctionnalités OpenAI
StreamingSSESSESSE
Appel de fonctionsOuiOui (personnalisés + intégrés)Oui
RaisonnementOuiRéflexion étendueOui
Sortie structuréeJSON schema, grammarJSON schemaJSON schema
Outils intégrésRecherche web, exécution de codeRecherche web, recherche de fichiers, interpréteur de code, utilisation de l’ordinateur, MCP
Les trois points de terminaison partagent la même authentification — il suffit de transmettre votre clé API en tant que jeton Bearer dans l’en-tête Authorization.