إنشاء رسالة

نظرة عامةCopy Anchor Link

توفّر هذه النقطة الطرفية توافقًا أصليًا مع Anthropic Messages API. استخدم هذا مع نماذج Claude وميزات مثل التفكير الممتد.

يحافظ هذا المسار على عقد Anthropic الأصلي. يجب أن تكون messages مصفوفة رسائل بأدوار user / assistant فقط، ويجب وضع system في الحقل العلوي system، كما أن max_tokens مطلوب. إذا كانت حمولة الطلب تستخدم أدوار OpenAI مثل system أو developer أو tool داخل messages، فأرسلها إلى /v1/chat/completions بدلًا من ذلك.

ترويسات الطلبCopy Anchor Link

جسم الطلبCopy Anchor Link

الاستجابةCopy Anchor Link

curl -X POST "https://api.tokenlab.sh/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-5",
    "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-5",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 10
  }
}

مثال على إدخال الرؤيةCopy Anchor Link

بالنسبة إلى نماذج Claude التي تدعم الرؤية، ضع الصور داخل messages[].content ككتل صور مُنظَّمة.

{
  "model": "claude-sonnet-5",
  "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-5",
  "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..."
          }
        }
      ]
    }
  ]
}

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

عيّن TOKENLAB_THINKING_MODEL إلى نموذج يدعم التفكير اليدوي باستخدام type: "enabled" وbudget_tokens. اضبط ميزانيتي التوكنات وفق حدود ذلك النموذج. قد تتطلب النماذج الأخرى إعدادات thinking مختلفة.

import os
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh"
)

message = client.messages.create(
    model=os.environ["TOKENLAB_THINKING_MODEL"],
    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}")

دفعات رسائل AnthropicCopy Anchor Link

يوفّر TokenLab الآن تدفق 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

ملاحظات تشغيلية:

• استخدم نفس مفتاح TokenLab API مع ترويسات Anthropic الأصلية.
• إذا كانت عناصر الـ batch تشير إلى file_id، فأضف أيضًا anthropic-beta: files-api-2025-04-14.
• تحافظ مهام الـ batch على شكل الطلب/الاستجابة الأصلي لـ Anthropic، بينما يتتبع TokenLab داخليًا دورة التسوية الخاصة بها.