Documentation officielle de développement Magick API

Bienvenue sur Magick API. Cette page, basée sur la documentation source réorganisée, vous propose le chemin d'intégration le plus court pour effectuer votre premier appel.

Astuce : il vous suffit de remplacer le nom de domaine et la clé API par ceux de Magick API pour migrer en un clic, sans aucune modification de code !

Domaine : "https://api.magickapi.com" , parfaitement compatible avec les interfaces de style OpenAI
Clé API : générée depuis le panneau d'administration

Étape 1 : Obtenir une clé API

Ouvrez la page de gestion des clés API.
Connectez-vous à votre compte et créez une nouvelle clé API.
Conservez précieusement la clé ; lors des appels suivants, transmettez-la via Authorization: Bearer VOTRE_CLE_API.

Étape 2 : Choisir le type d'interface

Les interfaces texte et la plupart des interfaces image renvoient généralement les résultats de manière synchrone ; les interfaces vidéo utilisent un mode de tâche asynchrone et renvoient id / task_id après soumission réussie.

Modèles généralistes

Adaptés à la génération de texte, aux dialogues multi-tours, aux entrées multimodales et aux appels d'outils.

Modèles de génération d'images

Adaptés à la génération texte-vers-image, image-vers-image, à la retouche localisée et à la génération à partir de plusieurs images de référence.

Modèles vidéo

Adaptés à la génération texte-vers-vidéo, à la génération vidéo à partir d'une première image ou d'une première et dernière image, et à la poursuite de vidéo.

Étape 3 : Envoyer une requête

Exemple de génération de texte

curl -X POST https://api.magickapi.com/v1/chat/completions \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {
        "role": "user",
        "content": "Aidez-moi à rechercher et recommander le grand modèle le plus adapté au codage"
      }
    ]
  }'

Exemple de génération d'image

curl -X POST https://api.magickapi.com/v1/images/generations \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Un chat mignon assis sur la banquette arrière d'une Rolls-Royce en train de pleurer",
    "size": "1:1",
    "n": 1
  }'

Exemple de génération vidéo

curl -X POST https://api.magickapi.com/v1/videos \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "Une petite fille assise sur le rebord de la fenêtre admire les saules agités par la brise printanière",
    "duration": 8,
    "size": "1280x720"
  }'

Étape 4 : Interroger l'état de la tâche

Après que l'interface vidéo renvoie id / task_id, interrogez le résultat via l'endpoint vidéo compatible OpenAI :

curl -X GET https://api.magickapi.com/v1/videos/VOTRE_TASK_ID \
  -H "Authorization: Bearer VOTRE_CLE_API"

Une fois la tâche terminée, téléchargez le contenu vidéo :

curl -L https://api.magickapi.com/v1/videos/VOTRE_TASK_ID/content \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  --output output.mp4

Il est conseillé d'attendre 5 à 10 secondes après la soumission avant de commencer l'interrogation, puis de répéter la requête toutes les 3 à 5 secondes.

Prochaines étapes

Interface de dialogue textuel : commencez par l'interface de dialogue généraliste (flux par défaut).
OpenAI Responses : lisez l'interface multimodale OpenAI Responses.
Génération d'images : lisez GPT-Image-2 Génération d'images.
Génération vidéo : lisez VEO3 Génération vidéo.

Démarrage rapide