Passer au contenu principal
POST
/
v1
/
messages
curl https://api.apimart.ai/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2025-10-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, world"}
    ]
  }'
{
  "code": 200,
  "data": {
    "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
    "type": "message",
    "role": "assistant",
    "content": [
      {
        "type": "text",
        "text": "Hello! I'm Claude. Nice to meet you."
      }
    ],
    "model": "claude-sonnet-4-5-20250929",
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "usage": {
      "input_tokens": 12,
      "output_tokens": 18
    }
  }
}

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 https://api.apimart.ai/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2025-10-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, world"}
    ]
  }'
{
  "code": 200,
  "data": {
    "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
    "type": "message",
    "role": "assistant",
    "content": [
      {
        "type": "text",
        "text": "Hello! I'm Claude. Nice to meet you."
      }
    ],
    "model": "claude-sonnet-4-5-20250929",
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "usage": {
      "input_tokens": 12,
      "output_tokens": 18
    }
  }
}

Autorisations

x-api-key
string
requis
Clé API pour l’authentificationRendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez dans l’en-tête de la requête :
x-api-key: YOUR_API_KEY
anthropic-version
string
requis
Version de l’APIIndique la version de l’API Claude à utiliserExemple : 2025-10-01

Body

model
string
défaut:"claude-haiku-4-5-20251001"
requis
Nom du modèle
  • 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
messages
array
requis
Liste des messagesTableau de messages à partir desquels le modèle générera la prochaine réponse. 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 dans role : user (message utilisateur) ou assistant (réponse de l’IA, pour conversations multi-tours)
  3. Saisissez dans content : le texte de votre message
Message utilisateur unique :
[{"role": "user", "content": "Hello, Claude"}]
Conversation multi-tours :
[
  {"role": "user", "content": "Hello there."},
  {"role": "assistant", "content": "Hi, I'm Claude. How can I help you?"},
  {"role": "user", "content": "Can you explain LLMs in plain English?"}
]
Réponse assistant pré-remplie :
[
  {"role": "user", "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"},
  {"role": "assistant", "content": "The best answer is ("}
]
max_tokens
integer
Nombre maximal de tokens à générerNombre maximal de tokens à générer avant l’arrêt. Le modèle peut s’arrêter avant d’atteindre cette limite.Les différents modèles ont des valeurs maximales différentes. Minimum : 1
system
string | array
Invite systèmeLes invites système définissent le rôle, la personnalité, les objectifs et les instructions de Claude.Format chaîne :
{
  "system": "You are a professional Python programming tutor"
}
Format structuré :
{
  "system": [
    {
      "type": "text",
      "text": "You are a professional Python programming tutor"
    }
  ]
}
temperature
number
Paramètre de température, plage 0–1Contrôle l’aléa de la sortie :
  • Valeurs basses (par exemple 0.2) : plus déterministe, conservateur
  • Valeurs hautes (par exemple 0.8) : plus aléatoire, créatif
Par défaut : 1.0
top_p
number
Paramètre d’échantillonnage par noyau (nucleus sampling), plage 0–1Utilise l’échantillonnage par noyau. Il est recommandé d’utiliser soit temperature soit top_p, mais pas les deux.Par défaut : 1.0
top_k
integer
Échantillonnage Top-KÉchantillonne uniquement parmi les K meilleures options, supprime les réponses « à longue traîne » de faible probabilité.Recommandé uniquement pour les cas d’usage avancés.
stream
boolean
Activer le streamingLorsque true, utilise Server-Sent Events (SSE) pour transmettre les réponses en flux.Par défaut : false
stop_sequences
array
Séquences d’arrêtSéquences de texte personnalisées qui font arrêter la génération du modèle.Maximum 4 séquences.Exemple : ["\n\nHuman:", "\n\nAssistant:"]
metadata
object
MétadonnéesObjet de métadonnées pour la requête.Inclut :
  • user_id : identifiant utilisateur
tools
array
Définitions des outilsListe des outils que le modèle peut utiliser pour accomplir des tâches.Exemple d’outil de fonction :
{
  "tools": [
    {
      "name": "get_weather",
      "description": "Get the current weather in a given location",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "The city and state, e.g. San Francisco, CA"
          },
          "unit": {
            "type": "string",
            "enum": ["celsius", "fahrenheit"],
            "description": "Temperature unit"
          }
        },
        "required": ["location"]
      }
    }
  ]
}
Types d’outils pris en charge :
  • Outils de fonction personnalisés
  • Outil d’utilisation d’ordinateur (computer_20241022)
  • Outil éditeur de texte (text_editor_20241022)
  • Outil Bash (bash_20241022)
tool_choice
object
Stratégie de choix d’outilContrôle la façon dont le modèle utilise les outils :
  • {"type": "auto"} : décision automatique (par défaut)
  • {"type": "any"} : doit utiliser un outil
  • {"type": "tool", "name": "tool_name"} : utiliser un outil spécifique

Response

id
string
Identifiant unique du messageExemple : "msg_013Zva2CMHLNnXjNJJKqJ2EF"
type
string
Type d’objetToujours "message"
role
string
RôleToujours "assistant"
content
array
Tableau de blocs de contenuContenu généré par le modèle, sous forme de tableau de blocs de contenu.Contenu texte :
[{"type": "text", "text": "Hello! I'm Claude."}]
Utilisation d’un outil :
[
  {
    "type": "tool_use",
    "id": "toolu_01A09q90qw90lq917835lq9",
    "name": "get_weather",
    "input": {"location": "San Francisco, CA", "unit": "celsius"}
  }
]
Types de contenu :
  • text : contenu textuel
  • tool_use : invocation d’outil
model
string
Modèle ayant traité la requêteExemple : "claude-sonnet-4-5-20250929"
stop_reason
string
Raison de l’arrêtValeurs possibles :
  • end_turn : achèvement naturel
  • max_tokens : nombre maximal de tokens atteint
  • stop_sequence : séquence d’arrêt rencontrée
  • tool_use : invocation d’un outil
stop_sequence
string | null
Séquence d’arrêt déclenchéeLa séquence d’arrêt qui a été générée, le cas échéant ; sinon null
usage
object
Statistiques d’utilisation des tokens

Exemples d’utilisation

Conversation simple

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.apimart.ai"
)

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explain quantum computing basics"}
    ]
)

print(message.content[0].text)

Conversation multi-tours

messages = [
    {"role": "user", "content": "What is machine learning?"},
    {"role": "assistant", "content": "Machine learning is a branch of AI..."},
    {"role": "user", "content": "Can you give a practical example?"}
]

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=messages
)

Utilisation d’invites système

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    system="You are a senior Python developer expert in code review and optimization.",
    messages=[
        {"role": "user", "content": "How to optimize this code?\n\n[code]"}
    ]
)

Réponse en streaming

with client.messages.stream(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Write a short essay about AI"}
    ]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Utilisation d’outils

tools = [
    {
        "name": "get_stock_price",
        "description": "Get real-time stock price",
        "input_schema": {
            "type": "object",
            "properties": {
                "ticker": {
                    "type": "string",
                    "description": "Stock ticker symbol, e.g., AAPL"
                }
            },
            "required": ["ticker"]
        }
    }
]

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    tools=tools,
    messages=[
        {"role": "user", "content": "What's Tesla's stock price?"}
    ]
)

# Handle tool calls
if message.stop_reason == "tool_use":
    tool_use = next(block for block in message.content if block.type == "tool_use")
    print(f"Calling tool: {tool_use.name}")
    print(f"Arguments: {tool_use.input}")

Compréhension d’images

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://example.com/image.jpg"
                    }
                },
                {
                    "type": "text",
                    "text": "Describe this image"
                }
            ]
        }
    ]
)

Image en Base64

import base64

with open("image.jpg", "rb") as image_file:
    image_data = base64.b64encode(image_file.read()).decode("utf-8")

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": "image/jpeg",
                        "data": image_data
                    }
                },
                {
                    "type": "text",
                    "text": "Analyze this image"
                }
            ]
        }
    ]
)

Bonnes pratiques

1. Ingénierie des prompts

Définition claire du rôle :
system = """You are an experienced data scientist specializing in:
- Statistical analysis and data visualization
- Machine learning model development
- Python and R programming
Provide professional, accurate advice."""
Sortie structurée :
message = "Please return the analysis results in JSON format with summary, key_findings, and recommendations fields."

2. Gestion des erreurs

from anthropic import APIError, RateLimitError

try:
    message = client.messages.create(
        model="claude-sonnet-4-5-20250929",
        max_tokens=1024,
        messages=[{"role": "user", "content": "Hello"}]
    )
except RateLimitError:
    print("Rate limit exceeded, please retry later")
except APIError as e:
    print(f"API error: {e}")

3. Optimisation des tokens

# Use shorter prompts
messages = [
    {"role": "user", "content": "Summarize key points:\n\n[long text]"}
]

# Limit output length
message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=500,  # Limit output
    messages=messages
)

4. Préremplissage des réponses

# Guide model to specific format
messages = [
    {"role": "user", "content": "List 5 Python best practices"},
    {"role": "assistant", "content": "Here are 5 Python best practices:\n\n1."}
]

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=messages
)

Gestion des réponses en streaming

Streaming en Python

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.apimart.ai"
)

with client.messages.stream(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Write a Python decorator example"}
    ]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Streaming en JavaScript

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.API_KEY,
  baseURL: 'https://api.apimart.ai'
});

const stream = await client.messages.stream({
  model: 'claude-sonnet-4-5-20250929',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'Write a React component example' }
  ]
});

for await (const chunk of stream) {
  if (chunk.type === 'content_block_delta' && 
      chunk.delta.type === 'text_delta') {
    process.stdout.write(chunk.delta.text);
  }
}

Remarques importantes

  1. Sécurité des clés API :
    • Stockez les clés API dans des variables d’environnement
    • N’inscrivez jamais les clés en dur dans le code source
    • Faites tourner les clés régulièrement
  2. Limitation du débit :
    • Tenez compte des limites de débit de l’API
    • Implémentez des mécanismes de relance
    • Utilisez un backoff exponentiel
  3. Gestion des tokens :
    • Surveillez l’utilisation des tokens
    • Optimisez la longueur des prompts
    • Utilisez des valeurs max_tokens appropriées
  4. Sélection du modèle :
    • Opus : tâches complexes nécessitant une réflexion approfondie
    • Sonnet : performance et coût équilibrés
    • Haiku : réponse rapide, tâches simples
  5. Filtrage du contenu :
    • Validez les entrées utilisateur
    • Filtrez les informations sensibles
    • Mettez en place une modération du contenu