Questions fréquentes

Des réponses courtes, chacune complète à elle seule. Pour la valeur exacte à envoyer dans model, consultez la page Modèles ; pour le prix du jour, la page de chaque modèle sur oceantoken.ai.

Qu’est-ce qu’OceanToken ?

OceanToken, c’est une API et un solde prépayé pour plus de 500 modèles d’IA : des modèles de texte, d’image, de vidéo, de synthèse vocale, de transcription, d’embeddings et de rerank d’OpenAI, Anthropic, Google, DeepSeek, Qwen, ByteDance et d’environ 60 autres éditeurs. Vous créez un compte, ajoutez des crédits, créez une clé API, puis appelez n’importe quel modèle avec la même URL de base et la même clé. Le prix, la fenêtre de contexte et les capacités de chaque modèle figurent dans le catalogue avant que vous ne l’appeliez.

OceanToken est-il compatible avec OpenAI ? Quels SDK fonctionnent ?

Oui. L’API OceanToken parle l’API OpenAI : les SDK officiels d’OpenAI pour Python, TypeScript et d’autres langages fonctionnent en changeant deux valeurs, l’URL de base en https://api.oceantoken.ai/v1 et la clé API en votre clé OceanToken. Tous les modèles de chat, dont Claude, GPT, Gemini et DeepSeek, répondent aussi à l’API Messages d’Anthropic sur /v1/messages : le SDK Anthropic fonctionne donc tel quel avec les deux mêmes changements ; il prend l’URL de base https://api.oceantoken.ai et ajoute /v1 lui-même. Chat completions, l’API Responses, les images, la vidéo, les embeddings, la synthèse vocale, la transcription et le rerank suivent tous les mêmes formats.

Quels modèles d’IA puis-je appeler avec OceanToken ?

Le catalogue compte plus de 500 modèles de 7 types : modèles de langage (GPT, Claude, Gemini, DeepSeek, Qwen, GLM, Kimi, Grok, Mistral, Llama et d’autres), modèles de génération et de retouche d’images, modèles de génération vidéo, synthèse vocale, reconnaissance vocale, embeddings de texte et rerankers. La page Modèles les liste tous avec leur ID exact, leur prix unitaire, leur fenêtre de contexte et leur prise en charge du raisonnement, des appels d’outils ou des images en entrée. La liste est reconstruite à partir du service en production à chaque publication de la documentation.

Combien coûte OceanToken ? Y a-t-il des frais de plateforme ?

Vous payez à l’usage, au prix affiché pour chaque modèle, en dollars américains, à partir d’un solde prépayé ; il n’y a pas d’abonnement. Les modèles sont facturés à l’usage, sans frais de plateforme. Lors d’une recharge, des frais de traitement de 2,9 % + 0,30 $ du montant total payé sont ajoutés au paiement, identiques pour tous les moyens de paiement ; ils ne s’ajoutent pas à votre solde. Par exemple, 100 $ de crédits coûtent 103,30 $. Les modèles de langage sont facturés par million de tokens d’entrée, d’entrée en cache et de sortie (et d’écriture en cache, quand le modèle la facture) ; les images, par image, par mégapixel ou par token d’image ; la vidéo, à la seconde ; la synthèse vocale, par tranche de 1 000 caractères ; la transcription, à la minute d’audio ; et le rerank Cohere, par unité de recherche. Le prix d’un modèle est le même à toute heure, et smart-router est facturé au prix du modèle qu’il choisit. Certains modèles portent l’étiquette :free et ne coûtent rien, avec un débit limité. La page de chaque modèle sur oceantoken.ai affiche son prix actuel avant que vous ne fassiez un appel.

Pourquoi mon prompt Claude n’est-il pas mis en cache ?

Claude ne met un prompt en cache que si la requête le demande. Marquez la fin de la partie répétée avec "cache_control": {"type": "ephemeral"} sur un bloc de contenu, sur /v1/chat/completions ou /v1/messages ; à partir de la requête suivante, cette partie est lue depuis le cache et facturée au prix d’entrée en cache du modèle. Les modèles GPT, DeepSeek, Qwen et GLM utilisent le cache d’eux-mêmes. Un succès apparaît dans usage : prompt_tokens_details.cached_tokens sur chat completions, cache_read_input_tokens sur /v1/messages. Claude ne met en cache qu’un préfixe au-delà d’une longueur minimale, de 512 à 4 096 tokens selon le modèle. La référence de l’API donne des exemples pour les deux formats.

Comment utiliser OceanToken avec Claude Code, Codex, Cursor ou Gemini CLI ?

Lancez une commande dans un terminal et connectez-vous : npx -y @oceantoken/cli@latest connect codex (ou claude-code, cursor, gemini, openclaw). Elle ajoute à cet agent le serveur MCP d’OceanToken, https://mcp.oceantoken.ai/mcp, et 3 skills, avec lesquels il peut chercher des modèles, estimer des coûts et générer des images, des vidéos et de la voix à partir de votre solde. Un agent IA peut aussi suivre seul les instructions de https://mcp.oceantoken.ai/install. La même clé API fonctionne dans tout outil compatible OpenAI en réglant l’URL de base.

OceanToken génère-t-il des images, des vidéos et de la voix, pas seulement du texte ?

Oui. Les modèles d’image répondent sur /v1/images/generations et /v1/images/edits, les modèles vidéo sur /v1/videos sous forme de tâches asynchrones que vous interrogez, la synthèse vocale sur /v1/audio/speech, la transcription sur /v1/audio/transcriptions, les embeddings sur /v1/embeddings et les rerankers sur /v1/rerank. Les 7 types utilisent la même clé et le même solde, et chaque requête apparaît dans les Journaux de la console avec son coût et sa latence. Les URL de téléchargement des images et des vidéos restent valides 24 heures, et les tâches vidéo acceptent un Idempotency-Key, si bien qu’une nouvelle tentative ne peut jamais lancer ni facturer une seconde tâche.

Puis-je limiter ce qu’une clé API peut dépenser ?

Oui. Chaque clé API peut avoir sa propre limite de crédits, avec une remise à zéro quotidienne, hebdomadaire ou mensuelle si vous le souhaitez, ainsi qu’une date d’expiration : une clé de projet de test ou de collègue ne peut donc pas puiser dans le solde partagé au-delà de ce que vous autorisez ; une clé qui a atteint sa limite reçoit une erreur 400 key_budget_exceeded même si le compte a encore des crédits. La console affiche l’usage de chaque clé, et la page Journaux liste chaque requête avec son modèle, ses tokens, son coût et sa latence. Les clés ne sont affichées qu’une fois, à leur création, et peuvent être renouvelées avec un chevauchement de 24 heures.

Comment fonctionnent la facturation et le solde prépayé ?

Vous ajoutez des crédits par carte dans la console, en choisissant 5 $, 10 $, 25 $ ou 50 $, ou en saisissant votre propre montant. Lors d’une recharge, des frais de traitement de 2,9 % + 0,30 $ du montant total payé sont ajoutés au paiement, identiques pour tous les moyens de paiement ; ils ne s’ajoutent pas à votre solde. Votre première recharge rapporte aussi un bonus de 10 % du crédit acheté, jusqu’à 100 $ (les règles sont dans Bonus de première recharge : https://docs.oceantoken.ai/fr/get-started/add-credits#first-top-up-bonus ). Chaque requête déduit son coût exact de ce solde prépayé au prix affiché pour le modèle au moment de l’appel, jamais rétroactivement. Les crédits achetés sont valables 12 mois à compter de l’achat (Conditions d’utilisation, section 6), et il n’y a pas de minimum mensuel. Tant que le solde est inférieur ou égal à 0 $, toute requête vers un modèle payant est refusée jusqu’à ce que vous ajoutiez des crédits (les modèles dont l’ID se termine par :free fonctionnent toujours) ; les tâches longues comme la vidéo réservent leur coût estimé jusqu’à leur fin. Les dépenses par jour et par modèle s’affichent sur la page Activité.

OceanToken propose-t-il une offre gratuite ?

Les modèles dont l’ID se termine par :free ne coûtent rien, avec un débit limité et non garanti ; les filtres de la page Modèles les signalent par l’étiquette Free. Ils fonctionnent même avec un solde de 0 $ et leurs appels ne le réduisent pas : vous pouvez tester le format de l’API, la configuration du SDK et l’intégration à un agent sans rien dépenser, puis passer à un modèle payant en changeant seulement l’ID du modèle.

Quelles sont les limites de débit et les délais d’OceanToken ?

Les limites de débit s’appliquent par clé API, en requêtes par minute et en tokens par minute, et les réponses indiquent les limites de la clé dans les en-têtes x-oceantoken-key-rpm-limit et x-oceantoken-key-tpm-limit ; en dépasser une renvoie 429 rate_limited avec un en-tête Retry-After. Une requête synchrone dure au plus 240 secondes et son corps pèse au plus 10 Mo : utilisez stream: true pour les longues générations de texte et envoyez les gros fichiers sous forme d’URL. La génération vidéo s’exécute comme une tâche de plusieurs minutes : vous interrogez /v1/videos/{video_id} au lieu de garder une connexion ouverte. Les détails sont sur la page Limites.

Que se passe-t-il si un fournisseur de modèles tombe en panne ?

En général, vous ne voyez rien. De nombreux modèles, dont les modèles Claude et GPT actuels, ont plus d’un canal officiel ou autorisé ; quand l’un échoue, est saturé ou ne répond plus, OceanToken relance la requête et la fait passer par un autre canal du même modèle, au même prix. Il ne répond jamais avec un autre modèle, sauf si vous indiquez vous-même des modèles de secours avec le paramètre fallbacks, et une tentative qui échoue avant de produire une sortie n’est pas facturée. Les erreurs que n’importe quel canal renverrait, comme une requête mal formée ou un refus de sécurité, vous sont transmises directement, et un flux interrompu après le début de la sortie peut se terminer par une erreur : prévoyez donc une nouvelle tentative avec temporisation exponentielle pour les 429 et 5xx. La page Nouvelles tentatives et basculement donne les détails.