Guide utilisateur Magick API

Compatible avec l'API Claude Messages ; prend en charge system, tools, le contenu image et les événements de streaming ; la réponse réussie est conforme au protocole natif Claude.

Route : POST /v1/messages
La forme du protocole est alignée sur l'API Claude Messages
La réponse réussie est du JSON natif Claude ou du SSE natif Claude, sans enveloppe code / data

Exemple de requête

curl https://api.magickapi.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2025-10-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "system": "Tu es un assistant IA professionnel.",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Bonjour, le monde"
      }
    ]
  }'

Exemple de réponse réussie

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Bonjour ! Je suis Claude."
    }
  ],
  "model": "claude-sonnet-4-5-20250929",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 18
  }
}

Exemple de réponse d'erreur

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Paramètres de requête invalides"
  }
}

Authentification

`x-api-key`

Type : string
Obligatoire : Oui

`anthropic-version`

Type : string
Obligatoire : Oui

Il est recommandé que le SDK Claude ou Claude Code l'envoie normalement selon le protocole Anthropic.

Paramètres courants

`model`

Type : string
Obligatoire : Oui

`system`

Type : string | array

Le prompt système de Claude est un paramètre indépendant, il ne se place pas dans messages.

`messages`

Type : array
Obligatoire : Oui

Prend en charge les rôles user / assistant.

`max_tokens`

Type : integer

`stream`

Type : boolean

Lorsque true est passé, renvoie le flux d'événements SSE natif de Claude.

`tools` / `tool_choice`

Type : array / object

Le projet actuel transmet les champs liés aux outils selon le protocole natif de Claude.

Capacités multimodales et étendues

Contenu texte : pris en charge
Contenu image : pris en charge
Appels d'outils : pris en charge
Retour en streaming : pris en charge
thinking / output_config / context_management : le DTO du projet les prend déjà en charge, ils peuvent être envoyés selon les champs du protocole Claude

Notes de compatibilité

Si vous utilisez Claude Code, veuillez consulter en priorité « Outils de développement / Guide d'utilisation de Claude Code »

Claude Messages

Sommaire