Passer au contenu principal
POST
/
api
/
v1
/
chat
/
completions
curl --request POST \
  --url https://api.apimart.ai/api/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o", # Can be replaced with any supported model ID
    "stream": false,
    "messages": [
      {
        "role": "system",
        "content": "You are a professional AI assistant."
      },
      {
        "role": "user",
        "content": "Tell me about the history of artificial intelligence."
      }
    ]
  }'

{
  "code": 200,
  "data": {
    "id": "chatcmpl-9876543210",
    "object": "chat.completion",
    "created": 1677652288,
    "model": "gpt-4o",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "The history of artificial intelligence (AI) dates back to the 1950s...\n\n1. **Early Period (1950s-1960s)**: The proposal of the Turing Test marked the beginning of AI research...\n\n2. **Expert Systems Era (1970s-1980s)**: Rule-based systems began to be applied in medical diagnosis, financial analysis, and other fields...\n\n3. **Rise of Machine Learning (1990s-2000s)**: Statistical learning methods gradually became mainstream...\n\n4. **Deep Learning Revolution (2010s-Present)**: Breakthroughs in neural network technology brought explosive growth to AI..."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 28,
      "completion_tokens": 320,
      "total_tokens": 348
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/api/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o", # Can be replaced with any supported model ID
    "stream": false,
    "messages": [
      {
        "role": "system",
        "content": "You are a professional AI assistant."
      },
      {
        "role": "user",
        "content": "Tell me about the history of artificial intelligence."
      }
    ]
  }'

{
  "code": 200,
  "data": {
    "id": "chatcmpl-9876543210",
    "object": "chat.completion",
    "created": 1677652288,
    "model": "gpt-4o",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "The history of artificial intelligence (AI) dates back to the 1950s...\n\n1. **Early Period (1950s-1960s)**: The proposal of the Turing Test marked the beginning of AI research...\n\n2. **Expert Systems Era (1970s-1980s)**: Rule-based systems began to be applied in medical diagnosis, financial analysis, and other fields...\n\n3. **Rise of Machine Learning (1990s-2000s)**: Statistical learning methods gradually became mainstream...\n\n4. **Deep Learning Revolution (2010s-Present)**: Breakthroughs in neural network technology brought explosive growth to AI..."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 28,
      "completion_tokens": 320,
      "total_tokens": 348
    }
  }
}

​
Autorisations

​
Authorization
string
requis
Tous les points de terminaison de l’API nécessitent une authentification par Bearer TokenObtenez votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la dans l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
défaut:"gpt-5"
requis
Nom du modèleLes modèles pris en charge incluent :
  • OpenAI : gpt-5, gpt-5-chat-latest, gpt-5-mini, gpt-5-nano, gpt-5-pro
  • Anthropic : claude-sonnet-4-5-20250929, claude-opus-4-1-20250805, claude-haiku-4-5-20251001, claude-opus-4-1-20250805-thinking, claude-sonnet-4-5-20250929-thinking
  • Google : gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-pro-thinking, gemini-2.5-flash-lite
  • DeepSeek : deepseek-v3.1-250821, deepseek-v3.1-think-250821, deepseek-v3-0324
  • Doubao : doubao-seed-1-6-251015, doubao-seed-1-6-flash-250828, doubao-seed-1-6-thinking-250715
  • D’autres modèles sont ajoutés en permanence…
​
messages
array
requis
Liste des messages de la conversationTableau de messages. Chaque message contient les champs role et content.💡 Remplissage rapide (zone « Try it ») :
  1. Cliquez sur « + Add an item » pour ajouter un message
  2. Saisissez user (message utilisateur), assistant (réponse de l’IA) ou system (invite système) dans role
  3. Saisissez ce que vous souhaitez dire dans content
Exemple :
[{"role": "user", "content": "Hello, please introduce yourself"}]
Utilisation avancée :Ajouter une invite système (pour définir le comportement de l’IA) :
[
  {"role": "system", "content": "You are a professional Python tutor"},
  {"role": "user", "content": "How do I learn programming?"}
]
Conversation multi-tours (avec contexte) :
[
  {"role": "user", "content": "Hello"},
  {"role": "assistant", "content": "Hi! How can I help you?"},
  {"role": "user", "content": "Tell me about AI"}
]
Description des rôles :
  • user : message utilisateur (utilisé dans la plupart des cas)
  • system : invite système pour définir le comportement et le rôle de l’IA
  • assistant : réponses précédentes de l’IA, utilisées pour le contexte de la conversation
​
temperature
number
Contrôle l’aléa de la sortie, plage 0–2
  • Les valeurs plus faibles (par exemple 0.2) rendent la sortie plus déterministe
  • Les valeurs plus élevées (par exemple 1.8) rendent la sortie plus aléatoire
Par défaut : 1.0
​
max_tokens
integer
Nombre maximal de tokens à générerLes différents modèles ont des limites maximales différentes, veuillez consulter la documentation du modèle concerné
​
stream
boolean
défaut:"false"
Utiliser ou non la sortie en streaming
  • false : réponse complète en une seule fois
  • true : retour en streaming
Par défaut : false
​
top_p
number
Paramètre d’échantillonnage par noyau (nucleus sampling), plage 0–1Contrôle la diversité du texte généré, il est recommandé d’utiliser soit ce paramètre, soit temperaturePar défaut : 1.0
​
frequency_penalty
number
Pénalité de fréquence, plage de -2.0 à 2.0Des valeurs positives réduisent la probabilité de répéter les mêmes motsPar défaut : 0
​
presence_penalty
number
Pénalité de présence, plage de -2.0 à 2.0Des valeurs positives augmentent la probabilité d’aborder de nouveaux sujetsPar défaut : 0
​
stop
string or array
Séquences d’arrêtJusqu’à 4 séquences qui, lorsqu’elles sont rencontrées, stoppent la génération
​
n
integer
Nombre de complétions à générerPar défaut : 1⚠️ Remarque : Vous devez saisir un nombre simple (par exemple 1), sans guillemets, sinon une erreur se produira

​
Response

​
id
string
Identifiant unique de la réponse
​
object
string
Type d’objet, fixé à chat.completion
​
created
integer
Horodatage de création
​
model
string
Nom du modèle réellement utilisé
​
choices
array
Liste des réponses générées
​
usage
object
Statistiques d’utilisation des tokens

​
Modèles pris en charge

​
Série OpenAI

  • gpt-5 — modèle de base GPT-5
  • gpt-5-chat-latest — dernière version chat de GPT-5
  • gpt-5-mini — version légère de GPT-5, économique
  • gpt-5-nano — version ultra-légère de GPT-5
  • gpt-5-pro — version professionnelle améliorée de GPT-5

​
Série Anthropic

  • claude-haiku-4-5-20251001 — Claude 4.5, version à réponse rapide
  • claude-sonnet-4-5-20250929 — Claude 4.5, version équilibrée
  • claude-opus-4-1-20250805 — modèle phare Claude 4.1, le plus puissant
  • claude-opus-4-1-20250805-thinking — Claude 4.1 Opus, version à réflexion approfondie
  • claude-sonnet-4-5-20250929-thinking — Claude 4.5 Sonnet, version à réflexion approfondie

​
Série Google

  • gemini-2.5-flash — Gemini 2.5, version rapide
  • gemini-2.5-pro — Gemini 2.5, version professionnelle
  • gemini-2.5-flash-lite — Gemini 2.5, version ultra-légère
  • gemini-2.5-pro-thinking — Gemini 2.5 Pro, version à réflexion approfondie

​
Série DeepSeek

  • deepseek-v3.1-250821 — DeepSeek V3.1, version de base
  • deepseek-v3.1-think-250821 — DeepSeek V3.1, version avec réflexion
  • deepseek-v3-0324 — DeepSeek V3, version standard

​
Série Doubao

  • doubao-seed-1-6-flash-250828 — Doubao Seed 1.6, version rapide
  • doubao-seed-1-6-thinking-250715 — Doubao Seed 1.6, version avec réflexion
  • doubao-seed-1-6-251015 — Doubao Seed 1.6, version standard

​
Exemples d’utilisation

​
Conversation simple

{
  "model": "gpt-4o",
  "stream": false,
  "messages": [
    {"role": "user", "content": "Hello"}
  ]
}

​
Invite système

{
  "model": "claude-3-5-sonnet",
  "stream": false,
  "messages": [
    {"role": "system", "content": "You are a professional Python programming tutor"},
    {"role": "user", "content": "How to use list comprehensions?"}
  ]
}

​
Conversation multi-tours

{
  "model": "gemini-2.0-flash",
  "stream": false,
  "messages": [
    {"role": "user", "content": "What is machine learning?"},
    {"role": "assistant", "content": "Machine learning is a branch of artificial intelligence..."},
    {"role": "user", "content": "Can you give me an example?"}
  ]
}