Connecter des outils externes à l’API Cloud de OpenDesign

Choisir la connexion dont vous avez besoin

Pour importer une clé de fournisseur dans OpenDesign, suivez la procédure de configuration BYOK. Ce guide couvre le sens inverse : l’utilisation de l’API de modèles Cloud de OpenDesign depuis un outil externe tel que Claude Code ou Codex.

Avant de commencer

L’API Cloud OpenDesign est disponible avec les forfaits Go, Plus, Pro et Max. Le forfait Free n’est pas pris en charge. La liste Model de votre compte détermine les modèles de texte que vous pouvez utiliser ; les modèles présentés dans les captures d’écran sont des exemples et ne sont pas inclus dans tous les forfaits.

Les agents pris en charge sont Claude Code, Codex, Grok Build, OpenCode, OpenClaw et Hermes Agent. Installez d’abord l’agent de votre choix. Si CC Switch est déjà installé, vous pouvez ignorer son étape d’installation.

Ouvrir les clés API sur le Web

Connectez-vous à la gestion du compte OpenDesign sur le Web, puis choisissez API keys dans la barre latérale. Sélectionnez One-click agent setup en haut à droite. Vous pouvez commencer sans clé existante.

Pour une configuration manuelle, ouvrez Connection setup, sélectionnez le format d’API requis par votre outil — Chat Completions, Responses ou Messages — puis copiez son URL de base d’API. Veillez à utiliser le point de terminaison et le protocole correspondants. Les étapes ci-dessous montrent l’importation en un clic.

Étape 1 : installer et ouvrir CC Switch

1. Dans One-click agent setup, sélectionnez Download for Mac ou Download for Windows.
2. Installez et ouvrez CC Switch. Ignorez cette étape s’il est déjà installé.

Étape 2 : choisir un agent et un modèle

1. Sélectionnez l’agent cible. Claude Code est sélectionné par défaut.
2. Choisissez dans la liste Model un modèle de texte disponible avec votre forfait. Si aucun modèle n’est disponible, choisissez un autre agent ou vérifiez votre forfait ; copier le nom d’un modèle depuis une capture d’écran ne vous en accorde pas l’accès.

Étape 3 : importer et redémarrer

1. Sélectionnez Import into CC Switch. Cette action crée une clé portant le nom de l’agent et du système, par exemple Claude Code · Mac, puis ouvre CC Switch.
2. Autorisez Open CC Switch dans l’invite du navigateur. Vérifiez l’API Endpoint, la clé et le modèle dans CC Switch, puis sélectionnez Import.
3. Revenez à la page Web et sélectionnez Done, ou Set up another agent pour configurer une autre connexion.
4. Redémarrez l’agent cible. Pour Claude Code, quittez la session actuelle et exécutez claude dans un nouveau terminal.

Chaque configuration en un clic crée une nouvelle clé ; elle ne peut pas réutiliser une clé existante. Les clés existantes ne sont pas affectées. La configuration précédente de votre agent reste disponible dans CC Switch.

Vérifier la connexion active

1. Envoyez un court message dans l’agent redémarré et vérifiez qu’il répond.
2. Dans Claude Code, exécutez /status et comparez le modèle avec votre sélection. Utilisez la vue d’état équivalente dans les autres agents.
3. Sur la page Web API keys, vérifiez si l’heure Last used de la nouvelle clé est mise à jour.

Si l’ancien modèle est toujours actif, fermez l’ancienne session et redémarrez l’agent. Si le navigateur n’a pas ouvert CC Switch, vérifiez l’invite de confirmation près de la barre d’adresse, ouvrez CC Switch, puis sélectionnez de nouveau Open. Vous pourrez ensuite changer de modèle dans CC Switch sans recommencer la configuration.

Revenir à la configuration précédente ou révoquer l’accès

Dans CC Switch, recherchez la configuration précédente de l’agent et activez-la pour revenir à celle-ci. Supprimer une configuration CC Switch ne désactive pas la clé API. Révoquez la clé sur la page Web API keys lorsque vous souhaitez qu’elle cesse de fonctionner.

Consultez la page du compte pour connaître votre forfait actuel et les modèles disponibles. Consultez le tutoriel de configuration d’un agent en un clic pour voir l’enregistrement complet et les captures d’écran, ou Abonnements et facturation pour configurer votre compte.

Les appels d’API partagent-ils les crédits de l’application ?

Oui. Les appels d’API ordinaires partagent les quotas et les périodes d’utilisation du forfait avec l’application. Créer une autre clé ou changer d’agent ne les réinitialise pas. Les crédits promotionnels peuvent être soumis à des conditions d’éligibilité distinctes pour l’API. Consultez crédits et utilisation.

Ouvrez la console Cloud pour gérer les clés et l’utilisation. Les outils tels que Zcode qui acceptent un point de terminaison de modèle personnalisé et une clé peuvent être configurés pour le protocole d’API correspondant. Cela ne signifie pas que OpenDesign peut lancer cet outil comme agent local intégré.

Les requêtes contenant des images dépassent la limite de taille

Les recommandations actuelles de l’assistance indiquent une limite de 50 MiB pour le corps des requêtes API. Elle s’applique au corps entier, et non à chaque image ; l’encodage des images augmente également leur taille. Réduisez le nombre ou les dimensions des images, puis réessayez avec une petite requête. Si l’échec persiste, communiquez à l’assistance l’état de la réponse, l’heure de la requête et le modèle, sans divulguer votre clé.