Documentation API
Tout ce dont vous avez besoin pour intégrer API in One dans votre application.
Authentification
Toutes les requêtes API nécessitent un token Bearer dans l'en-tête Authorization. Vous pouvez gérer vos clés API depuis le tableau de bord.
Authorization: Bearer aio_your_api_key_hereObtenez votre clé API: Créez votre clé API gratuite depuis la page Clés API de votre tableau de bord. Les nouveaux comptes reçoivent des crédits bonus pour explorer la plateforme.
URL de base
https://apiin.one/api/v1Points d'accès API
/api/v1/images/generations/api/v1/videos/generations/api/v1/audio/music/api/v1/audio/speech/api/v1/chat/completions/api/v1/images/tools/remove-bg/api/v1/tasks/{task_id}Format de requête
Toutes les requêtes utilisent un corps JSON avec un champ 'model' obligatoire pour spécifier le modèle d'IA. Les paramètres supplémentaires varient selon le modèle.
{
"model": "flux-2",
"prompt": "A beautiful landscape",
"...other_params": "..."
}Le paramètre 'model' est toujours requis. Visitez la page de documentation de chaque modèle pour la liste complète des paramètres pris en charge.
Format de réponse
Tâches asynchrones (Image, Vidéo, Musique, Voix)
Pour les modèles de génération de contenu, l'API renvoie immédiatement un ID de tâche. Interrogez le point d'accès de statut pour vérifier l'achèvement de la tâche.
Initial response when task is created.
{
"id": "task_abc123",
"status": "pending",
"model": "kling-3",
"created_at": "2026-02-24T12:00:00Z"
}Réponses synchrones (Chat)
Les réponses de chat sont renvoyées directement dans une seule requête, au format compatible OpenAI.
{
"id": "chatcmpl_xyz",
"model": "gemini",
"choices": [
{
"message": {
"role": "assistant",
"content": "..."
}
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 156,
"total_tokens": 168
},
"credits_consumed": 2
}Gestion des erreurs
Toutes les erreurs renvoient un format JSON cohérent avec un code d'erreur, un message et un type.
{
"error": {
"code": 401,
"message": "Invalid API key",
"type": "authentication_error"
}
}| Status Code | Type | Requis | Description |
|---|---|---|---|
400 | invalid_request | Optionnel | Paramètres de requête invalides. Vérifiez la documentation du modèle pour les champs requis. |
401 | authentication_error | Optionnel | La clé API est manquante, invalide ou révoquée. |
402 | insufficient_credits | Optionnel | Votre compte n'a pas assez de crédits. Achetez plus de crédits pour continuer. |
404 | not_found | Optionnel | La ressource demandée (tâche, modèle) est introuvable. |
429 | rate_limit | Optionnel | Limite de débit dépassée. Par défaut : 60 requêtes par minute. |
500 | server_error | Optionnel | Erreur interne du serveur. Veuillez réessayer après un court délai. |
Démarrage rapide
1. Obtenir votre clé API
Inscrivez-vous et créez une clé API depuis votre tableau de bord. Les comptes gratuits incluent des crédits bonus.
2. Envoyer votre première requête
curl -X POST https://apiin.one/api/v1/images/generations \
-H "Authorization: Bearer aio_your_key" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2",
"prompt": "A serene Japanese garden with cherry blossoms"
}'3. Vérifier le statut de la tâche (modèles asynchrones)
curl https://apiin.one/api/v1/tasks/task_abc123 \
-H "Authorization: Bearer aio_your_key"4. Explorer plus de modèles
Parcourez notre répertoire de modèles pour trouver le modèle d'IA idéal pour votre cas d'utilisation.
Parcourir tous les modèles →API Tester
Test the API directly from your browser: