Interface de conversation générale (non-streaming)

Point d'entrée unifié compatible avec OpenAI Chat Completions ; utilise la même route que la documentation streaming ; la réponse réussie est le JSON brut d'OpenAI.

Route : POST /v1/chat/completions
Il ne s'agit pas d'une autre interface, mais simplement de la même route avec stream: false
La réponse réussie est le JSON brut d'OpenAI, sans enveloppe code / data

Exemple de requête

curl --request POST \
  --url https://api.magickapi.com/v1/chat/completions \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5",
    "stream": false,
    "messages": [
      {
        "role": "system",
        "content": "Vous êtes un assistant IA professionnel."
      },
      {
        "role": "user",
        "content": "Présentez l'\''histoire du développement de l'\''intelligence artificielle."
      }
    ]
  }'

Exemple de réponse réussie

{
  "id": "chatcmpl_123",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "gpt-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "L'histoire du développement de l'intelligence artificielle commence généralement dans les années 1950."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 20,
    "total_tokens": 48
  }
}

Exemple de réponse d'erreur

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request"
  }
}

Authentification

En-tête de requête : Authorization: Bearer YOUR_API_KEY
Veuillez utiliser la clé API générée dans le panneau d'administration de Magick API.

Paramètres courants

`model`

Type : string
Obligatoire : oui

`messages`

Type : array
Obligatoire : oui

Conforme au protocole OpenAI Chat Completions.

`stream`

Type : boolean
Valeur recommandée : false

Si vous avez besoin d'obtenir le résultat complet en une seule fois, veuillez passer explicitement false.

Autres champs courants

temperature
top_p
max_tokens
max_completion_tokens
tools
tool_choice
response_format
reasoning_effort

Note de compatibilité

Le streaming et le non-streaming utilisent tous deux POST /v1/chat/completions

Interface de conversation générale (non-streaming)

Sommaire