Référence API

Toutes les routes relayées par le hub, l’envoi des clés, les erreurs possibles et les limites applicables.

Points de terminaison

Route	Usage
POST `/v1/chat/completions`	OpenAI Chat Completions ; les appels en streaming incluent automatiquement les données d’utilisation.
POST `/v1/responses`	OpenAI Responses API, utilisée par Codex.
POST `/v1/embeddings`	Embeddings, pour les modèles qui les proposent.
POST `/v1/messages`	Anthropic Messages, pour Claude Code et Claude Desktop.
POST `/v1/messages/count_tokens`	Comptage des tokens ; jamais facturé.
POST `/v1beta/models/{model}:generateContent`	Protocole natif Gemini, réponse unique.
POST `/v1beta/models/{model}:streamGenerateContent?alt=sse`	Protocole natif Gemini, en streaming via server-sent events.
GET `/v1/models` · GET `/v1beta/models`	Listes de modèles aux formats OpenAI et Gemini ; nécessitent une clé, sans frais.

Envoi de la clé

Utilisez Authorization: Bearer, x-api-key ou x-goog-api-key ; les clients Gemini peuvent aussi ajouter ?key=, qui est supprimé avant la transmission.

curl · Gemini

curl --request POST "https://api.coderelayhub.com/v1beta/models/gemini-3.8-flash:generateContent" \
  --header "x-goog-api-key: crh_paste_your_key_here" --header "Content-Type: application/json" \
  --data '{"contents":[{"role":"user","parts":[{"text":"Summarize git rebase in one line"}]}]}'

Codes d’erreur

Chaque appel est facturé selon les tokens déclarés par le fournisseur. Les erreurs sont renvoyées au format d’erreur OpenAI.

HTTP	type	Signification sur le hub
`400`	`invalid_request_error` · `model_not_found`	Requête mal formée, modèle manquant, modèle inconnu ou modèle envoyé au mauvais protocole.
`401`	`authentication_error`	Aucune clé API n’a été envoyée, ou la clé est inconnue ou révoquée.
`402`	`insufficient_quota`	Le solde est à zéro (clé à l’usage) ou le forfait mensuel correspondant est épuisé. Rechargez pour continuer.
`403`	`permission_error`	Le compte est suspendu, ou une clé de forfait mensuel a appelé un modèle hors de sa famille.
`413`	`invalid_request_error`	Corps de requête supérieur à 25 Mo.
`429`	`rate_limit_error`	Plus de 120 appels par minute avec une même clé, ou déjà 8 appels en cours pour le compte.
`502`	`api_error`	Le fournisseur n’a pas pu être joint et rien n’a été facturé.

Limites

120 requêtes par minute glissante et par clé.
8 requêtes simultanées par compte.
25 Mo par corps de requête ; aucun délai d’expiration n’interrompt les flux longs.