Prise en main de l'AICU API

Copiez cette page dans votre agent de code. Tout ce qui suit s'applique à chaque endpoint ; les pages par service (Chat, Images, Audio, Lectures X) n'ajoutent que ce qui leur est propre.

URL de base

https://api.aicu.ai/v1

Les surfaces compatibles OpenAI se trouvent sous /v1 (chat, audio) et /v2.5 (images, pour que images.edit() du SDK OpenAI fonctionne en changeant seulement base_url).

Authentification

Authorization: Bearer aicu_live_xxxxxxxxxxxxxxxx

Créez une clé depuis le tableau de bord : https://api.aicu.ai/dashboard/keys

• C'est le serveur qui décide du préfixe de la clé. aicu_live_ est une clé de production ; aicu_test_ est une clé hors production, déclarée comme telle, que vous pouvez demander ; les clés aicu_beta_ appartiennent au programme bêta et expirent à la date de fin du programme (voir les actualités).
• Les clés portent des scopes (llm, tts, images, x). Les nouvelles clés reçoivent tous les scopes publics disponibles. Appeler un endpoint hors des scopes de votre clé renvoie 403 avec un corps {"error": "API key does not have required scope: <scope>", "required_scope": "<scope>", "current_scopes": [...]}. Attention : cette erreur ne suit pas la forme {error: {code, message}} utilisée ailleurs — error est une simple chaîne et il n'y a pas de code. Basez votre logique sur required_scope. Ajoutez le scope manquant avec 権限変更 (Modifier les autorisations) dans dashboard/keys — inutile de recréer la clé.
• Une seule clé donne accès à tous les services. Pas de clés par fournisseur à gérer.

Crédits (AP prépayés)

• L'utilisation se paie en AP, une unité prépayée : 1 USD = 10,000 AP. Les montants en yens affichés ici ou là sont approximatifs.
• Seules les réponses HTTP 200 sont facturées. Les erreurs et les réponses en cache ne coûtent rien. Quand le solde atteint zéro, la clé s'arrête avec 402 ; rien n'est débité automatiquement, sauf si vous activez la recharge automatique.
• Votre premier appel d'API crédite un nouveau compte de l'équivalent de 10 $ en AP.
• Les tarifs par modèle sont publiés et révisés chaque semaine ; les hausses sont annoncées au moins sept jours à l'avance dans les actualités. La liste de prix lisible par machine est GET /v1/models (également sur la page des tarifs).
• Repères : la synthèse vocale (TTS) coûte 200 AP pour 1,000 caractères ; la transcription (STT) 3 AP par tranche de 10 secondes d'audio ; la génération d'images est facturée par image produite selon la taille et la qualité (voir Images).
• Solde et historique par requête : https://api.aicu.ai/dashboard/history

Erreurs

Toutes les erreurs utilisent la même enveloppe :

{ "error": { "code": "insufficient_ap", "message": "Not enough AP." } }

• code est un contrat fixe en anglais — basez votre logique dessus. message est destiné aux humains et suit la langue de votre compte.
• Certaines erreurs ajoutent des champs à côté de error (par exemple required_scope et current_scopes sur un 403 de scope).
• La liste complète, par statut, se trouve dans le document OpenAPI : https://api.aicu.ai/openapi.json (components.responses). Les plus courantes :

Statut	Codes	Signification
400	invalid_json, invalid_parameter, unsupported_parameter	Le corps de la requête ou un paramètre est incorrect
401	unauthorized, api_key_not_found, expired	Corrigez la clé
402	insufficient_ap, service_budget_exhausted	Rechargez, ou attendez le budget de la campagne
403	forbidden_scope (et card_required à partir du 2026-10-21)	Scope ou carte exigée
422	content_moderated	Le fournisseur a refusé le contenu
429	rate_limited, user_daily_cap	Ralentissez, ou attendez la remise à zéro du plafond quotidien
5xx	generation_failed, internal_error	Réessayez avec un délai croissant (backoff)

Un 403 avec error code: 1010 de Cloudflare et sans corps JSON signifie qu'aucun en-tête User-Agent n'a été envoyé (le comportement par défaut de urllib et d'outils similaires). Définissez-en un.

Limites de débit

60 requêtes par minute et par clé par défaut. Besoin de plus pour une charge de production ? Contactez-nous.

Requêtes de longue durée

La génération d'images peut dépasser la limite de 100 secondes de l'edge. L'id de la réponse (ou l'en-tête X-AICU-Image-Id en streaming) vous permet de récupérer le résultat plus tard avec GET /v1/images/status/{id}. Rien n'est perdu quand la connexion HTTP se ferme.

SDK

• SDK OpenAI : fonctionne tel quel. Réglez base_url sur https://api.aicu.ai/v1 pour le chat et l'audio, et sur https://api.aicu.ai/v2.5 pour images.generate() / images.edit().
• TypeScript : voir SDK TypeScript.
• Agents : collez l'URL d'un skill — https://api.aicu.ai/skills (LLM, TTS, STT, X).

Assistance

• Signalez un problème depuis le tableau de bord : chaque page du tableau de bord comporte une carte Support à droite (sous le contenu sur téléphone). Elle est repliée au départ : cliquez sur son titre pour l'ouvrir. Choisissez bug, facturation, question ou demande, écrivez une ligne, et pour un appel en échec ajoutez l'endpoint, le modèle, le statut HTTP, l'heure (pré-remplie avec votre fuseau horaire), le request_id et le corps de la réponse. Vous recevez une référence SR-XXXXXXXX, et le panneau affiche le statut de chaque signalement (reçu, en cours, résolu, remboursé).
  • Un bug confirmé est remboursé ; le remboursement apparaît dans votre historique d'utilisation. Nous ne répondons pas individuellement — le statut dans le panneau est la réponse.
  • Ne collez pas votre clé API complète. Si vous le faites, elle est masquée avant l'enregistrement du signalement.
  • Jusqu'à 10 signalements par 24 heures. Les questions en anglais, en français ou en japonais sont les bienvenues.
• Ou écrivez à api@aicu.ai (répondez à n'importe quel e-mail de notre part), ou utilisez https://aicu.ai/contact
• Statut : https://api.aicu.ai/status · Actualités et avis de prix : https://api.aicu.ai/news

© 2026 AICU Inc.