Een Message maken
Roep Claude aan via het CometAPI Messages-endpoint met tekst- en afbeeldingsinvoer, adaptief denken, Prompt-caching, Streaming en tools.
POST /v1/messages om Claude-aanvragen te verzenden in de Anthropic Messages-indeling.
De voorbeelden configureren de officiële Anthropic SDK met de CometAPI-basis-URL en
lezen je API-sleutel uit $COMETAPI_KEY.
x-api-key of Authorization: Bearer. De Anthropic SDK gebruikt
x-api-key. De HTTP-voorbeelden bevatten anthropic-version: 2023-06-01.Snel aan de slag
De volgende voorbeelden vragen drie zoekopdrachten aan. Stel$COMETAPI_KEY in voordat
je ze uitvoert. Installeer anthropic voor Python of @anthropic-ai/sdk voor JavaScript:
content-array. Lees blokken waarvan type text is;
Thinking- en toolblokken kunnen vóór de tekst verschijnen.
Adaptief denken beheren
Stelthinking.type in op adaptive en kies een waarde voor output_config.effort.
In het volgende voorbeeld wordt xhigh gebruikt en wordt het voltooide bericht uit een stream gelezen:
max_tokens. Laat ook ruimte over voor het uiteindelijke
antwoord, naast het denken. Een response kan tekst bevatten zonder een zichtbaar
denkblok. Bewaar geretourneerde denkblokken ongewijzigd in de conversatiegeschiedenis.
geschiedenis.
Zie voor de modelspecifieke denkconfiguratie
Thinking.
In de voorbeelden ontbreken temperature, top_p en top_k; raadpleeg de parameterdocumentatie van het geselecteerde
model voordat je sampling controls toevoegt.
Prompts cachen
Plaats een cache breakpoint op referentiemateriaal dat je tussen requests hergebruikt. Sla je referentiemateriaal op in een UTF-8-bestandreference.txt voordat je dit
voorbeeld uitvoert. Gebruik een prefix die voldoet aan de vereisten van het geselecteerde model voor
minimale cachebare lengte:
cache_creation_input_tokenstelt Tokens die naar de cache zijn geschreven.cache_read_input_tokenstelt Tokens die uit de cache zijn gelezen.input_tokenstelt input die buiten die cachetellers is verwerkt.
cache_read_input_tokens hoeveel input-Tokens
uit de cache zijn gelezen. Het OpenAPI- Prompt Cache
-voorbeeld bevat een volledige fictieve referentie die je kunt opslaan als
reference.txt om het voorbeeld te proberen.
Responses streamen
Stelstream: true in voor Server-Sent Events. De SDK stelt tekstfragmenten beschikbaar zodra ze
binnenkomen:
message_start, contentblock-gebeurtenissen, message_delta,
en message_stop. Content blocks kunnen tekst, denkactiviteit of toolactiviteit bevatten.
Voor een tekstblok bevat content_block_delta een text_delta. Lees het uiteindelijke verbruik
en de stopreden uit message_delta.
Inspanning beheren
Steloutput_config.effort in om de hoeveelheid redenering te sturen. Dit voorbeeld gebruikt
low voor een korte uitleg en wacht op het voltooide gestreamde bericht:
max_tokens afzonderlijk in om de uitvoerlengte te beperken.
Servertools gebruiken
Servertools worden tijdens de API-aanvraag uitgevoerd en retourneren resultaatblokken naast het antwoord van Claude.- Web Fetch
- Web Search
web_fetch_tool_result blok:server_tool_use-blok aan een web_fetch_tool_result
met daarin het opgehaalde document of een toolfout.Resultaten van clienttools retourneren
Voor een clienttool retourneert Claude eentool_use-blok. Voer de functie van uw applicatie uit
en stuur het resultaat in een tool_result-blok met de overeenkomende tool_use_id.
Behoud de volledige assistant content tussen de twee aanvragen.
Dit voorbeeld levert een fictief bestelresultaat en vraagt Claude dat resultaat te gebruiken:
Voorbeeld van een respons
Een niet-streaming aanvraag retourneert een message object. Het volgende voorbeeld toont de tekst- en usage-velden met een illustratieve message identifier:end_turn voltooit het antwoord,
max_tokens betekent dat de output de limiet heeft bereikt, en tool_use vraagt om een clienttool
resultaat. Voor een server-toolbeurt die pause_turn retourneert, gaat u verder met de
geretourneerde assistant content ongewijzigd.Autorisaties
Your CometAPI key passed via the x-api-key header. Authorization: Bearer $COMETAPI_KEY is also supported.
Headers
The Anthropic API version to use. Defaults to 2023-06-01.
"2023-06-01"
Comma-separated feature identifiers required by a specific beta API feature. Omit this header for the examples on this page.
Body
The Claude model to use. See the Models page for available Claude model IDs.
"claude-opus-5"
Conversation history. Use user and assistant messages with text strings or content-block arrays. Return complete assistant content blocks when continuing a tool call.
The maximum number of tokens to generate. The model may stop before reaching this limit. When using thinking, the thinking tokens count towards this limit.
x >= 11024
System prompt providing context and instructions to Claude. Can be a plain string or an array of content blocks (useful for prompt caching).
Sampling temperature. The examples omit sampling overrides.
0 <= x <= 1Nucleus sampling threshold. The examples omit sampling overrides.
0 <= x <= 1Limits sampling to the k most likely tokens. The examples omit sampling overrides.
x >= 0If true, stream the response incrementally using Server-Sent Events (SSE). Events include message_start, content_block_start, content_block_delta, content_block_stop, message_delta, and message_stop.
Custom strings that cause the model to stop generating when encountered. The stop sequence is not included in the response.
Thinking configuration. The adaptive example uses type adaptive and sets output_config.effort separately.
Client tools define a name and input_schema. Server tools use a versioned type and name, such as the web_fetch and web_search examples on this page.
Controls how the model uses tools.
Request metadata for tracking and analytics.
Configuration for reasoning effort and structured output.
The service tier to use. auto tries priority capacity first, standard_only uses only standard capacity.
auto, standard_only Respons
Successful response. When stream is true, the response is a stream of SSE events.
Message identifier returned by the API.
Always message.
message Always assistant.
assistant The response content blocks. May include text, thinking, tool_use, and other block types.
Model ID reported by the response.
Why the model stopped generating. refusal can be returned as a successful HTTP response when the model declines a request.
end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal The stop sequence that caused the model to stop, if applicable.
Token usage statistics.