الانتقال إلى المحتوى الرئيسي

نظرة عامة

توفّر هذه النقطة الطرفية توافقًا أصليًا مع Anthropic Messages API. استخدم هذا مع نماذج Claude وميزات مثل التفكير الممتد.
عنوان URL الأساسي لـ Anthropic SDK: https://api.lemondata.cc (بدون اللاحقة /v1)

ترويسات الطلب

x-api-key
string
مطلوب
مفتاح LemonData API الخاص بك. بديل عن Bearer token.
anthropic-version
string
مطلوب
إصدار Anthropic API. استخدم 2023-06-01.

جسم الطلب

model
string
مطلوب
معرّف نموذج Claude (على سبيل المثال، claude-sonnet-4-6 أو claude-opus-4-6).
messages
array
مطلوب
مصفوفة من كائنات الرسائل تحتوي على role و content.
max_tokens
integer
مطلوب
الحد الأقصى لعدد الـ tokens المطلوب إنشاؤها.
system
string
System prompt (منفصل عن مصفوفة messages).
temperature
number
افتراضي:"1"
درجة حرارة أخذ العينات (0-1).
stream
boolean
افتراضي:"false"
تمكين الاستجابات المتدفقة.
thinking
object
إعدادات التفكير الممتد (Claude Opus 4.5).
  • type (string): "enabled" للتمكين
  • budget_tokens (integer): ميزانية الـ tokens الخاصة بالتفكير
tools
array
الأدوات المتاحة للنموذج.
tool_choice
object
كيفية استخدام النموذج للأدوات. الخيارات: auto، any، tool (أداة محددة).
top_p
number
معلمة Nucleus sampling. استخدم إما temperature أو top_p، وليس كليهما.
top_k
integer
أخذ العينات فقط من أعلى K خيارات لكل token.
stop_sequences
array
تسلسلات إيقاف مخصصة ستؤدي إلى توقف النموذج عن التوليد.
metadata
object
بيانات وصفية لإرفاقها بالطلب لأغراض التتبع.

الاستجابة

id
string
معرّف فريد للرسالة.
type
string
دائمًا message.
role
string
دائمًا assistant.
content
array
مصفوفة من كتل المحتوى (text، thinking، tool_use).
model
string
النموذج المستخدم.
stop_reason
string
سبب توقف التوليد (end_turn، max_tokens، tool_use).
usage
object
استخدام الـ tokens مع input_tokens و output_tokens.
curl -X POST "https://api.lemondata.cc/v1/messages" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "You are a helpful assistant.",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 10
  }
}

Vision Input Example

For Claude models with vision support, place images inside messages[].content as structured image blocks.
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Please describe this image."
        },
        {
          "type": "image",
          "source": {
            "type": "url",
            "url": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Please describe this image."
        },
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

مثال على التفكير الممتد

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[{"role": "user", "content": "Solve this math problem..."}]
)

for block in message.content:
    if block.type == "thinking":
        print(f"Thinking: {block.thinking}")
    elif block.type == "text":
        print(f"Response: {block.text}")

Anthropic Message Batches

يوفّر LemonData الآن تدفق Anthropic Message Batches الأصلي إلى جانب /v1/messages. المسارات المتاحة:
  • POST /v1/messages/batches
  • GET /v1/messages/batches
  • GET /v1/messages/batches/:message_batch_id
  • GET /v1/messages/batches/:message_batch_id/results
  • POST /v1/messages/batches/:message_batch_id/cancel
  • DELETE /v1/messages/batches/:message_batch_id
ملاحظات تشغيلية:
  • استخدم نفس مفتاح LemonData API مع ترويسات Anthropic الأصلية.
  • إذا كانت عناصر الـ batch تشير إلى file_id، فأضف أيضًا anthropic-beta: files-api-2025-04-14.
  • تحافظ مهام الـ batch على شكل الطلب/الاستجابة الأصلي لـ Anthropic، بينما يتتبع LemonData داخليًا دورة التسوية الخاصة بها.