إنشاء رسالة

POST

messages

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.cometapi.com",
    api_key=os.environ["COMETAPI_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "Hello, world"}
    ],
)

print(message.content[0].text)

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "text": "<string>",
      "thinking": "<string>",
      "signature": "<string>",
      "id": "<string>",
      "name": "<string>",
      "input": {}
    }
  ],
  "model": "<string>",
  "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
    },
    "output_tokens_details": {
      "thinking_tokens": 123
    }
  }
}

يدعم CometAPI واجهة Anthropic Messages API بشكل أصيل، مما يمنحك وصولًا مباشرًا إلى نماذج Claude مع ميزات خاصة بـ Anthropic. استخدم نقطة النهاية هذه لإمكانات Claude مثل التفكير التكيفي، وتخزين Prompt مؤقتًا، والتحكم في مستوى الجهد.

استخدم مرجع Anthropic Messages API الرسمي باعتباره المصدر المعتمد للقائمة الكاملة للمعلمات، ومخطط الاستجابة، والسلوك الخاص بـ Claude. تشرح صفحة CometAPI هذه كيفية إرسال صيغة الطلب هذه عبر CometAPI.

يمكن أن تتغير معلمات طلب Anthropic وحقول الاستجابة مع تطور ميزات Claude. راجع توثيق Anthropic Messages API للحصول على أحدث قائمة كاملة بالمعلمات والسلوك الخاص بمزود الخدمة.

ترفض العديد من نماذج Claude الأحدث قيم temperature وtop_p وtop_k غير الافتراضية في Messages API. احذف حقول أخذ العينات هذه ما لم تكن قد تحققت من دعم النموذج المحدد لها. إذا أعاد النموذج خطأ يشير إلى معلمة غير مدعومة أو معلمة مهجورة، فأزل الحقل من الطلب.

يتم دعم كل من ترويستي x-api-key وAuthorization: Bearer للمصادقة. تستخدم حزم SDK الرسمية الخاصة بـ Anthropic الترويسة x-api-key افتراضيًا.

بداية سريعة

لاستخدام حزمة Anthropic SDK الرسمية مع CometAPI، عيّن base URL:

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.cometapi.com",
    api_key=os.environ["COMETAPI_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)

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

const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
});

const message = await client.messages.create({
    model: "claude-sonnet-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello!" }],
});
console.log(message.content[0].text);

التحكم في التفكير التكيفي

استخدم التفكير التكيفي مع output_config.effort للتحكم في مقدار العمل الذي يطبقه Claude على الاستجابة. ترفض نماذج Claude الأحدث البنية اليدوية القديمة للتفكير thinking={"type": "enabled", "budget_tokens": ...}.

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=4096,
    thinking={"type": "adaptive"},
    output_config={"effort": "xhigh"},
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between a monolithic architecture and microservices for a small engineering team.",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

تُحتسب Tokens التفكير ضمن حد max_tokens الخاص بك. اضبط max_tokens على قيمة مرتفعة بما يكفي لكل من التفكير والإجابة النهائية عند استخدام مستويات جهد أعلى.

تخزين Prompt مؤقتًا

لتقليل زمن الاستجابة والتكلفة في الطلبات اللاحقة، خزّن system prompts الكبيرة أو بدايات المحادثة. أضف cache_control إلى كتل content التي يجب تخزينها مؤقتًا:

message = client.messages.create(
    model="claude-sonnet-5",
    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 (تُحتسب بتكلفة أعلى)
cache_read_input_tokens — Tokens تمت قراءتها من cache (تُحتسب بتكلفة مخفضة)

يتطلب Prompt caching حدًا أدنى قدره 1,024 tokens في كتلة content المخزنة مؤقتًا. أي content أقصر من ذلك لن يتم تخزينه مؤقتًا.

بث Responses

لبث Responses باستخدام Server-Sent Events (SSE)، اضبط stream: true. تصل الأحداث بهذا الترتيب:

message_start — يحتوي على بيانات message الوصفية والاستخدام الأولي
content_block_start — يحدد بداية كل كتلة content
content_block_delta — مقاطع نصية تدريجية (text_delta)
content_block_stop — يحدد نهاية كل كتلة content
message_delta — يتضمن stop_reason النهائي وusage الكامل
message_stop — يشير إلى نهاية البث

with client.messages.stream(
    model="claude-sonnet-5",
    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-sonnet-5",
    max_tokens=4096,
    messages=[
        {"role": "user", "content": "Summarize this briefly."}
    ],
    output_config={"effort": "low"},  # "low", "medium", "high", "xhigh", or "max"
)

استخدام أدوات الخادم

يدعم Claude أدوات تعمل على جانب الخادم وتُشغَّل على البنية التحتية الخاصة بـ Anthropic:

Web Fetch
Web Search

اجلب المحتوى من عناوين URL وحلّله:

message = client.messages.create(
    model="claude-sonnet-5",
    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-5",
    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}
    ],
)

مثال على الاستجابة

استجابة نموذجية من نقطة نهاية Anthropic في CometAPI:

{
  "id": "msg_bdrk_01UjHdmSztrL7QYYm7CKBDFB",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "model": "claude-sonnet-5",
  "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
  }
}

مقارنة مع نقطة نهاية OpenAI-compatible

الميزة	Anthropic Messages (`/v1/messages`)	OpenAI-Compatible (`/v1/chat/completions`)
التفكير التكيفي	`thinking` مع `type: "adaptive"` و`output_config.effort`	غير متاح
تخزين Prompt مؤقتًا	`cache_control` على كتل content	غير متاح
التحكم في الجهد	`output_config.effort`	غير متاح
جلب/بحث الويب	أدوات الخادم (`web_fetch`, `web_search`)	غير متاح
ترويسة المصادقة	`x-api-key` أو `Bearer`	`Bearer` فقط
تنسيق الاستجابة	تنسيق Anthropic (`content` blocks)	تنسيق OpenAI (`choices`, `message`)
النماذج	Claude فقط	متعدد المزوّدين (GPT، Claude، Gemini، إلخ)

التفويضات

x-api-key

string

header

مطلوب

Your CometAPI key passed via the x-api-key header. Authorization: Bearer $COMETAPI_KEY is also supported.

الترويسات

anthropic-version

string

افتراضي:2023-06-01

The Anthropic API version to use. Defaults to 2023-06-01.

مثال:

"2023-06-01"

anthropic-beta

string

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.

الجسم

application/json

model

string

مطلوب

The Claude model to use. See the Models page for available Claude model IDs.

مثال:

"claude-sonnet-5"

messages

object[]

مطلوب

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

max_tokens

integer

مطلوب

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 >= 1

مثال:

1024

system

System prompt providing context and instructions to Claude. Can be a plain string or an array of content blocks (useful for prompt caching).

temperature

number

افتراضي:1

Model-dependent sampling control. Many newer Claude models reject non-default temperature values on the Messages API. Omit this field unless you have verified that the selected model accepts it; if the model returns an unsupported or deprecated-parameter error, remove the field instead of substituting another sampling value.

النطاق المطلوب: 0 <= x <= 1

مثال:

1

top_p

number

Model-dependent nucleus sampling control. Many newer Claude models reject non-default top_p values on the Messages API. Omit this field unless you have verified support for the selected model. Do not set temperature and top_p together.

النطاق المطلوب: 0 <= x <= 1

مثال:

1

top_k

integer

Model-dependent top-k sampling control. Many newer Claude models reject non-default top_k values on the Messages API. Omit this field unless you have verified support for the selected model.

النطاق المطلوب: x >= 0

مثال:

0

stream

boolean

افتراضي:false

If 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.

stop_sequences

string[]

Custom strings that cause the model to stop generating when encountered. The stop sequence is not included in the response.

thinking

object

Controls Claude thinking when the selected model supports a configurable thinking mode. For newer adaptive-thinking models, use {"type":"adaptive"} with output_config.effort, or omit thinking when adaptive thinking is already the model default. Manual {"type":"enabled","budget_tokens":...} is supported only by older models and is rejected by newer Claude models.

Show child attributes

tools

object[]

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

tool_choice

object

Controls how the model uses tools.

Show child attributes

metadata

object

Request metadata for tracking and analytics.

Show child attributes

output_config

object

Configuration for response effort and output format. Field support depends on the selected Claude model.

Show child attributes

service_tier

enum<string>

The service tier to use. auto tries priority capacity first, standard_only uses only standard capacity.

الخيارات المتاحة:

auto,

standard_only

الاستجابة

200 - application/json

Successful response. When stream is true, the response is a stream of SSE events.

string

Unique identifier for this message (e.g., msg_01XFDUDYJgAACzvnptvVoYEL).

type

enum<string>

Always message.

الخيارات المتاحة:

message

role

enum<string>

Always assistant.

الخيارات المتاحة:

assistant

content

object[]

The response content blocks. May include text, thinking, tool_use, and other block types.

Show child attributes

model

string

The specific model version that generated this response, such as claude-sonnet-5.

stop_reason

enum<string>

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

stop_sequence

string | null

The stop sequence that caused the model to stop, if applicable.

usage

object

Token usage statistics.

Show child attributes

إنشاء استجابة نموذج

إنشاء المحتوى

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.cometapi.com",
    api_key=os.environ["COMETAPI_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "Hello, world"}
    ],
)

print(message.content[0].text)

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "text": "<string>",
      "thinking": "<string>",
      "signature": "<string>",
      "id": "<string>",
      "name": "<string>",
      "input": {}
    }
  ],
  "model": "<string>",
  "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
    },
    "output_tokens_details": {
      "thinking_tokens": 123
    }
  }
}

الإشراف على المحتوى

مفاتيح API

بداية سريعة

التحكم في التفكير التكيفي

تخزين Prompt مؤقتًا

بث Responses

التحكم في الجهد

استخدام أدوات الخادم

مثال على الاستجابة

مقارنة مع نقطة نهاية OpenAI-compatible

التفويضات

الترويسات

الجسم

الاستجابة

​بداية سريعة

​التحكم في التفكير التكيفي

​تخزين Prompt مؤقتًا

​بث Responses

​التحكم في الجهد

​استخدام أدوات الخادم

​مثال على الاستجابة

​مقارنة مع نقطة نهاية OpenAI-compatible

التفويضات

الترويسات

الجسم

الاستجابة

بداية سريعة

التحكم في التفكير التكيفي

تخزين Prompt مؤقتًا

بث Responses

التحكم في الجهد

استخدام أدوات الخادم

مثال على الاستجابة

مقارنة مع نقطة نهاية OpenAI-compatible