مرجع API
أدلة التكامل
الأخطاء
الأسعار والفوترة
Anthropic Messages
استخدم واجهة Anthropic Messages API عبر CometAPI للوصول إلى نماذج Claude مع التفكير الموسّع، وتخزين Prompt مؤقتًا، واستخدام الأدوات، والبحث/الجلب من الويب، وStreaming، والتحكم في effort.
{
"id": "<string>",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "<string>",
"thinking": "<string>",
"signature": "<string>",
"id": "<string>",
"name": "<string>",
"input": {}
}
],
"model": "<string>",
"stop_reason": "end_turn",
"stop_sequence": "<string>",
"usage": {
"input_tokens": 123,
"output_tokens": 123,
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"cache_creation": {
"ephemeral_5m_input_tokens": 123,
"ephemeral_1h_input_tokens": 123
}
}
}نظرة عامة
يدعم CometAPI واجهة Anthropic Messages API بشكل أصلي، مما يمنحك وصولًا مباشرًا إلى نماذج Claude مع جميع الميزات الخاصة بـ Anthropic. استخدم نقطة النهاية هذه لقدرات Claude الحصرية مثل التفكير الموسّع، وتخزين Prompt مؤقتًا، والتحكم في effort.البدء السريع
استخدم Anthropic SDK الرسمي — فقط اضبط base URL إلى CometAPI:import anthropic
client = anthropic.Anthropic(
base_url="https://api.cometapi.com",
api_key="<COMETAPI_KEY>",
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)
x-api-key والترويسة Authorization: Bearer للمصادقة. تستخدم Anthropic SDKs الرسمية الترويسة x-api-key افتراضيًا.Extended Thinking
فعّل الاستدلال خطوة بخطوة في Claude باستخدام المعاملthinking. تتضمن الاستجابة كتل محتوى thinking تعرض الاستدلال الداخلي لـ Claude قبل الإجابة النهائية.
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=16000,
thinking={
"type": "enabled",
"budget_tokens": 10000,
},
messages=[
{"role": "user", "content": "Prove that there are infinitely many primes."}
],
)
for block in message.content:
if block.type == "thinking":
print(f"Thinking: {block.thinking[:200]}...")
elif block.type == "text":
print(f"Answer: {block.text}")
budget_tokens مقداره 1,024. يتم احتساب Tokens الخاصة بـ Thinking ضمن حد max_tokens — لذا اضبط max_tokens بقيمة مرتفعة بما يكفي لاستيعاب كلٍّ من Thinking والاستجابة.Prompt Caching
قم بتخزين Promptات النظام الكبيرة أو بدايات المحادثة مؤقتًا لتقليل زمن الاستجابة والتكلفة في الطلبات اللاحقة. أضفcache_control إلى كتل المحتوى التي يجب تخزينها مؤقتًا:
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
system=[
{
"type": "text",
"text": "You are an expert code reviewer. [Long detailed instructions...]",
"cache_control": {"type": "ephemeral"},
}
],
messages=[{"role": "user", "content": "Review this code..."}],
)
usage ضمن الاستجابة:
cache_creation_input_tokens— Tokens التي تمت كتابتها إلى التخزين المؤقت (تُحتسب بتكلفة أعلى)cache_read_input_tokens— Tokens التي تمت قراءتها من التخزين المؤقت (تُحتسب بتكلفة مخفضة)
Streaming
قم ببث Responses باستخدام Server-Sent Events (SSE) عبر تعيينstream: true. تصل الأحداث بهذا الترتيب:
message_start— يحتوي على بيانات message الوصفية والاستخدام الأوليcontent_block_start— يحدد بداية كل كتلة محتوىcontent_block_delta— أجزاء نصية متزايدة (text_delta)content_block_stop— يحدد نهاية كل كتلة محتوىmessage_delta— قيمةstop_reasonالنهائية وusageالكاملmessage_stop— يشير إلى نهاية البث
with client.messages.stream(
model="claude-sonnet-4-6",
max_tokens=256,
messages=[{"role": "user", "content": "Hello"}],
) as stream:
for text in stream.text_stream:
print(text, end="")
التحكم في الجهد
تحكم في مقدار الجهد الذي يبذله Claude في إنشاء الاستجابة باستخدامoutput_config.effort:
message = client.messages.create(
model="claude-opus-4-6",
max_tokens=4096,
messages=[
{"role": "user", "content": "Summarize this briefly."}
],
output_config={"effort": "low"}, # "low", "medium", or "high"
)
أدوات الخادم
يدعم Claude أدوات من جهة الخادم تعمل على البنية التحتية الخاصة بـ Anthropic:- Web Fetch
- Web Search
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "Analyze the content at https://arxiv.org/abs/1512.03385"}
],
tools=[
{"type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5}
],
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "What are the latest developments in AI?"}
],
tools=[
{"type": "web_search_20250305", "name": "web_search", "max_uses": 5}
],
)
مثال على الاستجابة
استجابة نموذجية من endpoint الخاص بـ Anthropic في CometAPI:{
"id": "msg_bdrk_01UjHdmSztrL7QYYm7CKBDFB",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello!"
}
],
"model": "claude-sonnet-4-6",
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 19,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 4
}
}
الفروق الرئيسية عن endpoint المتوافق مع OpenAI
| الميزة | Anthropic Messages (/v1/messages) | OpenAI-Compatible (/v1/chat/completions) |
|---|---|---|
| التفكير الموسّع | المعامل thinking مع budget_tokens | غير متاح |
| التخزين المؤقت للـ Prompt | cache_control على كتل المحتوى | غير متاح |
| التحكم في الجهد | output_config.effort | غير متاح |
| Web fetch/search | أدوات الخادم (web_fetch, web_search) | غير متاح |
| ترويسة المصادقة | x-api-key أو Bearer | Bearer فقط |
| تنسيق الاستجابة | تنسيق Anthropic (كتل content) | تنسيق OpenAI (choices, message) |
| النماذج | Claude فقط | متعدد المزوّدين (GPT, Claude, Gemini, إلخ) |
التفويضات
Your CometAPI key passed via the x-api-key header. Authorization: Bearer <key> is also supported.
الترويسات
The Anthropic API version to use. Defaults to 2023-06-01.
"2023-06-01"
Comma-separated list of beta features to enable. Examples: max-tokens-3-5-sonnet-2024-07-15, pdfs-2024-09-25, output-128k-2025-02-19.
الجسم
The Claude model to use. See the Models page for current Claude model IDs.
"claude-sonnet-4-6"
The conversation messages. Must alternate between user and assistant roles. Each message's content can be a string or an array of content blocks (text, image, document, tool_use, tool_result). There is a limit of 100,000 messages per request.
Show child attributes
Show child attributes
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).
Controls randomness in the response. Range: 0.0–1.0. Use lower values for analytical tasks and higher values for creative tasks. Defaults to 1.0.
0 <= x <= 1Nucleus sampling threshold. Only tokens with cumulative probability up to this value are considered. Range: 0.0–1.0. Use either temperature or top_p, not both.
0 <= x <= 1Only sample from the top K most probable tokens. Recommended for advanced use cases only.
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.
Enable extended thinking — Claude's step-by-step reasoning process. When enabled, the response includes thinking content blocks before the answer. Requires a minimum budget_tokens of 1,024.
Show child attributes
Show child attributes
Tools the model may use. Supports client-defined functions, web search (web_search_20250305), web fetch (web_fetch_20250910), code execution (code_execution_20250522), and more.
Show child attributes
Show child attributes
Controls how the model uses tools.
Show child attributes
Show child attributes
Request metadata for tracking and analytics.
Show child attributes
Show child attributes
Configuration for output behavior.
Show child attributes
Show child attributes
The service tier to use. auto tries priority capacity first, standard_only uses only standard capacity.
auto, standard_only الاستجابة
Successful response. When stream is true, the response is a stream of SSE events.
Unique identifier for this message (e.g., msg_01XFDUDYJgAACzvnptvVoYEL).
Always message.
message Always assistant.
assistant The response content blocks. May include text, thinking, tool_use, and other block types.
Show child attributes
Show child attributes
The specific model version that generated this response (e.g., claude-sonnet-4-6).
Why the model stopped generating.
end_turn, max_tokens, stop_sequence, tool_use, pause_turn The stop sequence that caused the model to stop, if applicable.
Token usage statistics.
Show child attributes
Show child attributes
{
"id": "<string>",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "<string>",
"thinking": "<string>",
"signature": "<string>",
"id": "<string>",
"name": "<string>",
"input": {}
}
],
"model": "<string>",
"stop_reason": "end_turn",
"stop_sequence": "<string>",
"usage": {
"input_tokens": 123,
"output_tokens": 123,
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"cache_creation": {
"ephemeral_5m_input_tokens": 123,
"ephemeral_1h_input_tokens": 123
}
}
}