L’API NeverNo

Chaque requête part vers l’adresse ci-dessous et porte ta clé en jeton bearer, ou dans un en-tête x-api-key comme l’envoient les SDK Anthropic. Les clés commencent par nn_live_.

Les mêmes formats de requête et de réponse qu’OpenAI (et qu’Anthropic pour /messages), et les noms de Venice pour les outils d’image.

Envoie model et messages (rôles system ou developer, user, assistant et tool, jusqu’à 2 000 messages). Avec auto, NeverNo choisit le modèle le moins cher capable de bien répondre ; sinon, indique n’importe quel modèle de chat de /models. temperature, top_p, stop et seed sont transmis aux modèles qui les acceptent et laissés de côté pour les autres (leurs supported_parameters dans /models).

Les modèles marqués vision lisent les images : passe une partie de contenu de type image_url, avec une adresse https publique (qui répond directement, 4 Mo au plus) ou une URL data:image/png;base64,… (jusqu’à 20 images, 4,5 Mo par requête). Chaque image doit être un PNG, JPEG ou WebP fixe, de 256 à 4096 pixels de côté ; elle est contrôlée selon les limites fermes et le filtre de contenu du compte avant que le modèle la voie (aucune personne qui pourrait être mineure), puis envoyée réencodée sans métadonnées. Les contrôles sont facturés avec la réponse, au même tarif. max_tokens (ou max_completion_tokens) limite la réponse ; reasoning_effort active le raisonnement sur les modèles qui le permettent, renvoyé dans reasoning_content.

Recherche web : enable_web_search à on cherche sur le web (résultats Google) avant chaque réponse, auto seulement quand la question demande des faits récents, off jamais (par défaut). enable_web_scraping: true lit les pages web dont l’adresse figure dans le dernier message. Le modèle cite les pages en [1], [2]…, numérotées comme web_search_citations (titre, url, extrait), renvoyé dans la réponse et dans le premier morceau du streaming. Les deux sont facturés en crédits au coût réel × 2,5, avec la réponse (environ 0,25 crédit par recherche). Ils peuvent aussi être passés dans venice_parameters.

Passe tools (des fonctions décrites par un schéma JSON), et si tu veux tool_choice (auto, none, required ou une fonction nommée) et parallel_tool_calls. Quand le modèle appelle un outil, la réponse contient tool_calls et finish_reason vaut tool_calls ; exécute la fonction, puis renvoie le message de l’assistant suivi d’un message tool qui porte le résultat (tool_call_id), et le modèle répond à partir de ce résultat. Les modèles dont capabilities.tools est vrai dans /models le prennent en charge, auto compris ; les autres répondent par une erreur 400 claire tools_not_supported.

response_format: { "type": "json_object" } demande du JSON valide, et json_schema du JSON qui suit ton schéma, sur les modèles qui ont response_format et json_schema dans leurs capacités.

POST /messages parle le format d’Anthropic : system, blocs de texte, d’image, tool_use et tool_result, tools avec input_schema, tool_choice, stop_sequences, thinking, et les événements de streaming (message_start, content_block_start, text_delta, input_json_delta, content_block_stop, message_delta, message_stop, ping). La clé va dans x-api-key ou Authorization: Bearer ; anthropic-version et anthropic-beta sont acceptés.

Les noms de modèles Claude (claude-sonnet-…, claude-opus-…, claude-haiku-…, avec ou sans date) sont servis par le modèle Claude de la même famille listé dans /models, et tout autre identifiant de modèle de chat du catalogue fonctionne aussi : deepseek-v4-pro ou glm-5.2 par le même endpoint coûtent bien moins cher. Le modèle qui a répondu est indiqué dans l’en-tête X-NeverNo-Model. Les outils serveur propres à Anthropic (sa recherche web, son exécution de code) sont laissés de côté ; les outils de ton client fonctionnent normalement.

Tout outil qui accepte un fournisseur compatible OpenAI fonctionne avec l’adresse de base et une clé ; les modèles qui ont les outils dans /models tiennent le travail d’agent.

Envoie un prompt et, si tu veux, un model (par défaut z-image-turbo). Les images reviennent uniquement en b64_json : elles ne sont jamais stockées chez nous, il n’y a donc pas d’URL à récupérer plus tard. Décode le base64 et enregistre le fichier toi-même.

Chaque image fait environ un mégapixel : la size demandée est rapprochée du format pris en charge le plus proche (1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9), et la taille réellement produite est indiquée dans la réponse.

/embeddings renvoie les vecteurs du modèle de la mémoire de NeverNo (qwen3-embedding-0.6b, 1 024 valeurs, jusqu’à 128 entrées par requête) ; dimensions les raccourcit et encoding_format: "base64" est compris. Les noms de modèles d’OpenAI sont acceptés et servis par ce même modèle.

/audio/speech lit jusqu’à 4 096 caractères en MP3 avec les voix de l’application : tts-kokoro (par défaut, plusieurs langues), tts-xai, tts-qwen3, tts-inworld et tts-minimax ; voice est un nom de voix listé dans /models, et les noms d’OpenAI (tts-1, alloy, nova…) sont associés à Kokoro. /audio/transcriptions prend un file en multipart de 1 Mo au plus (WebM, Ogg, MP4/M4A, MP3, WAV, AAC), facturé à sa durée, et répond en json, text ou verbose_json.

1 crédit = 0,01 $. L’API est facturée au coût réel du modèle appelé, multiplié par 1,5 pour les modèles ouverts comme pour les modèles fermés (Claude, GPT, Gemini, Grok) et par 2,5 pour les images, sans abonnement obligatoire. Elle se paie sur un solde API séparé : les crédits inclus dans une offre et ceux achetés pour l’appli ne sont jamais dépensés par l’API, et l’API ne les dépense jamais.

Les recharges de 10 $, 25 $, 100 $, 500 $ ou 2 000 $ (n’importe quel montant de 10 $ à 2 000 $) ont un bonus de volume calculé sur le montant payé en un seul paiement : +6 % dès 100 $, +7 % dès 500 $, utilisable sur les modèles ouverts et les images. Les taxes sont comprises dans le prix, payé dans ta devise locale.

Crédit de départ : à la création de ta première clé API, ton compte reçoit 1 $ une seule fois, utilisable sur les modèles ouverts et les images seulement (un budget quotidien est partagé entre les nouveaux comptes, il peut donc être épuisé). L’abonnement « Dev », 25 $ par mois, ajoute 1 $ de crédit API par jour, pour les modèles ouverts et les images seulement, non reporté au lendemain ; sa limite de requêtes est celle de Pro+.

Avant un appel, le maximum qu’il peut coûter est réservé sur ton solde ; une fois terminé, tu paies le montant réel et le reste revient. Un appel qui échoue chez le fournisseur est remboursé.

Ce qu’un appel a coûté est renvoyé, en crédits, dans l’en-tête X-NeverNo-Credits des réponses non diffusées de /chat/completions et /messages (par exemple X-NeverNo-Credits: 0.8421, arrondi à 4 décimales) ; une réponse diffusée envoie ses en-têtes avant la fin et n’en porte donc pas. Quand une réponse est refusée, elle peut être offerte dans des limites : l’en-tête indique alors 0 et rien n’est débité.

Modèles Claude : les tokens lus dans le cache de prompt d’Anthropic coûtent 0,025 à 0,1 × le prix d’entrée selon le modèle (0,05 × pour Opus et Sonnet) et les tokens qui y sont écrits 1,25 × (2 × pour un cache d’une heure) ; /models liste cache_read_credits et cache_write_credits. La réservation suppose le pire cas (tout écrit), le règlement suit ce que le fournisseur rapporte.

Les modèles OpenAI écrivent tout le prompt dans leur cache à chaque appel et le facturent 1,25 × le prix d’entrée : leur input_credits dans /models l’inclut déjà ; les tokens relus coûtent cache_read_credits.

Chaque compte dispose d’un nombre de requêtes API par période glissante de 24 heures, selon son offre. Au-delà, les appels reçoivent une erreur 429 jusqu’à ce que la fenêtre avance.

Les erreurs suivent le format d’OpenAI, pour que les bibliothèques clientes affichent le message tel quel : { "error": { "message", "type", "code" } }.

Nous n’enregistrons ni ne conservons tes prompts, tes messages, les réponses ou les images. Rien d’une requête ne sert à entraîner un modèle. Les modèles privés tournent chez des fournisseurs qui ne gardent rien ; les modèles anonymisés sont appelés sans ton identité.

Ce que nous gardons, c’est ce qu’exige la facturation : l’heure de chaque appel, le modèle et les crédits débités, et la dernière utilisation de chaque clé.

Les mêmes limites fermes s’appliquent à tous, par l’API comme dans l’application : rien qui implique des mineurs, rien sur des personnes réelles sans leur accord, aucune aide réelle pour nuire gravement à autrui.