Hackathons : obtenir et utiliser votre clé
Vous participez à un hackathon soutenu par AICU. Cette page contient tout ce qu'il faut savoir : comment obtenir votre clé, une URL, tous les modèles de la plateforme sauf ceux d'Anthropic.
Votre clé
Il existe deux façons d'obtenir une clé de hackathon. Votre organisateur vous indique celle que votre événement utilise.
A. Échanger un bon sur member.aicu.ai (une clé par personne)
- Ouvrez l'invitation de votre organisateur et inscrivez-vous sur member.aicu.ai avec l'adresse e-mail que l'organisateur a enregistrée. Votre AICU ID est créé en même temps.
- Allez dans Échanger et saisissez le code du bon que votre organisateur vous donne.
- Lisez et acceptez les conditions d'utilisation d'AICU et les conditions du programme hackathon. L'échange n'est pas possible sans accepter les deux.
- Vos crédits offerts et votre propre clé s'affichent. La valeur de la clé n'est affichée qu'une seule fois — copiez-la tout de suite dans un gestionnaire de mots de passe ou une variable d'environnement. Nous ne l'affichons plus ensuite.
- Ensuite, connectez-vous au tableau de bord avec le même AICU ID. Le panneau Hackathon affiche vos crédits, leur expiration, le nom de votre clé et sa limite par jour (pas la valeur de la clé).
Aucune carte bancaire n'est enregistrée. Chaque personne échange une seule fois ; si votre compte détient déjà des crédits AICU, utilisez un nouveau compte pour le hackathon (les deux soldes ne peuvent pas expirer à des dates différentes).
B. Une clé d'équipe remise par l'organisateur
Certains événements utilisent une clé par équipe. Votre organisateur (en général un enseignant ou le responsable de l'événement) l'a reçue et vous la transmet. Vous n'avez besoin ni de compte ni de carte.
Pour les deux types de clé
- La valeur commence par
aicu_hack_. Le nom ressemble àAICU_Hack_<EVENT>_T<n>(par exempleAICU_Hack_ANGERS_T1), suivi d'un identifiant court pour une clé personnelle. - Elle expire au plus tard 14 jours après son émission, sans prolongation. Ensuite, chaque appel renvoie
401aveccode: "key_expired". - Gardez-la secrète. Mettez-la dans une variable d'environnement, jamais dans un dépôt public, une page web ou une application que vous distribuez. Une valeur qui commence par
aicu_hack_se repère facilement en cas de fuite. Si elle fuit ou si vous la perdez, écrivez immédiatement à api@aicu.ai (et prévenez votre organisateur) : nous la désactivons et en émettons une nouvelle.
export AICU_API_KEY=aicu_hack_...
Une seule URL pour tout
L'API est compatible OpenAI. N'importe quel SDK ou outil OpenAI fonctionne en changeant l'URL de base et la clé.
| Élément | Valeur |
|---|---|
| URL de base | https://api.aicu.ai/v1 |
| En-tête d'authentification | Authorization: Bearer $AICU_API_KEY |
| Liste des modèles (la référence) | GET https://api.aicu.ai/v1/models — sans clé |
curl https://api.aicu.ai/v1/chat/completions \
-H "Authorization: Bearer $AICU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5-mini", "messages": [{"role": "user", "content": "Trois noms pour une startup qui loue des vélos aux touristes"}]}'
from openai import OpenAI
client = OpenAI(base_url="https://api.aicu.ai/v1", api_key="aicu_hack_...")
r = client.chat.completions.create(model="gpt-5-mini", messages=[{"role": "user", "content": "Écris un pitch en une phrase"}])
print(r.choices[0].message.content)
Ce que vous pouvez en faire
| Vous voulez… | Commencez par | Guide |
|---|---|---|
| Rédiger des textes, un business model, un pitch | gpt-5-mini, gpt-5, deepseek-v3 | Chat (LLM) |
| Coder avec un agent | kimi-k2.7-code depuis OpenCode, Cline ou Continue | OpenCode |
| Créer un logo ou des images pour le site | gpt-image-2, nano-banana, sd3.5-large (Stability AI), qwen-image-3.0 | Images |
| Faire une courte vidéo teaser | wan3.0-video, gemini-omni-1.1-flash | Vidéo |
| Ajouter une voix off | eleven_v4_turbo, eleven_v4 | Audio |
Les prix évoluent, nous ne les recopions donc pas ici. Le prix de chaque modèle figure dans GET /v1/models et sur la page des tarifs, et chaque réponse indique son coût dans l'en-tête X-AICU-AP-Cost (1 USD = 10 000 AP).
Le texte, la synthèse vocale et la transcription coûtent si peu que vous les remarquerez à peine. Ce sont les images et la vidéo qui consomment le budget d'une équipe : une seule vidéo longue en haute résolution peut coûter plus que tout le reste de la journée. Faites d'abord un essai court en basse résolution.
Ce qui n'est pas disponible
- Les modèles Anthropic (Claude) ne sont pas disponibles. Il n'y a pas d'endpoint
/v1/messages: Claude Code ne peut donc pas être branché sur cette API. Pour coder, utilisez OpenCode aveckimi-k2.7-code. - Les modèles Google fonctionnent, mais coûtent plus cher ici que chez Google. Si votre équipe a surtout besoin de Gemini, un compte personnel Google AI Studio ou Google Cloud (avec son offre gratuite ou ses crédits d'essai) ira plus loin. Utilisez cette clé pour tout le reste.
Limites d'une clé de hackathon
Elles sont fixées à l'émission de la clé. Avec une clé personnelle (A), connectez-vous au tableau de bord avec votre AICU ID pour les voir dans le panneau Hackathon. Avec une clé d'équipe (B), demandez à votre organisateur.
| Limite | Ce qui se passe | Que faire |
|---|---|---|
| Plafond quotidien (toujours) | Les appels payants sont refusés jusqu'à la remise à zéro, à minuit heure du Japon (16 h CET / 15 h UTC en hiver) | Attendre la remise à zéro, ou demander à l'organisateur |
| Plafond par requête (souvent) | 403 request_too_expensive : un appel coûterait plus que le plafond | Baisser la résolution, la durée ou n |
| Modèles autorisés (parfois) | 403 model_not_allowed | Choisir un modèle autorisé, ou demander à l'organisateur |
| Expiration (toujours, ≤ 14 jours) | 401 key_expired | Le hackathon est terminé — merci d'avoir construit avec nous |
La transcription (
/v1/audio/transcriptions) ne fonctionne pas avec une clé qui a un plafond par requête, car son coût n'est connu qu'après le traitement de l'audio. Si votre projet en a besoin, demandez une clé séparée à votre organisateur.
Si votre équipe épuise son budget avant la fin, demandez à votre organisateur : du crédit peut être ajouté sur la même clé.
Règles
- Uniquement pour le hackathon. Pas d'usage commercial, pas de revente ni de prêt de la clé.
- Respectez les conditions d'utilisation, y compris les règles de contenu (pas de NSFW, rien d'illégal).
- Ne publiez la clé nulle part, y compris dans une démo que vous partagez.
En cas de problème
- Consultez les codes d'erreur : la plupart des échecs indiquent quoi changer.
- Demandez à votre organisateur.
- Utilisez le panneau Support à droite du tableau de bord (connectez-vous avec votre AICU ID), ou écrivez à api@aicu.ai. Indiquez la requête (endpoint, modèle, contenu envoyé), l'heure (avec le fuseau horaire) et la réponse (statut et corps). Les questions et rapports de bug en français ou en anglais sont les bienvenus. Un bug confirmé est remboursé.
Après l'événement, nous transmettons à votre organisateur un rapport d'utilisation (par équipe et par type de contenu : texte, images, voix, vidéo), pour que vous puissiez voir ce que votre équipe a réellement utilisé.