مرجع API

توثيق API

كل ما تحتاجه لدمج كلود ماكس في تطبيقاتك. نقاط وصول كاملة، أمثلة بـ 6 لغات برمجة، وجميع الـ 5 موديلات.

المصادقة

عنوان URL الأساسي

الإنتاج
https://claudemaxhub.com/api/v1

جميع طلبات API يجب أن تستخدم HTTPS.

ترويسة مفتاح API

ترويسة
Authorization: Bearer YOUR_API_KEY

مفتاح API الخاص بك يُقدم بعد تفعيل الفترة التجريبية. ضمّنه في كل طلب.

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

60 طلب في الدقيقة

نوع المحتوى

application/json

صيغة الاستجابة

JSON (UTF-8)

كيف تحصل على مفتاح API

سجّل للفترة التجريبية المجانية ← فعّل حسابك ← جد مفتاح API في لوحة التحكم.

الموديلات المتاحة

جميع الموديلات مشمولة — اختر الأنسب لاستخدامك.

الموديل معرّف API نافذة السياق الأفضل لـ
Claude Opus 5 claude-opus-5 200K التفكير المعقد، البحث، البرمجة
Claude Fable 5 claude-fable-5 1M المستندات الطويلة، قواعد الأكواد الكبيرة
Claude Opus 4 claude-opus-4-8 200K التحليل، التقارير التفصيلية
Claude Sonnet 4 claude-sonnet-4 200K الاستخدام العام، المحادثة، الكتابة
Claude Haiku claude-haiku 200K المهام السريعة، الردود الفورية
GET /api/v1/models يُرجع قائمة بجميع موديلات كلود المتاحة لحسابك.
cURL
curl https://claudemaxhub.com/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import requests

response = requests.get(
    "https://claudemaxhub.com/api/v1/models",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

models = response.json()
for model in models["data"]:
    print(f"{model['id']}: {model['description']}")
JavaScript
const response = await fetch(
  'https://claudemaxhub.com/api/v1/models',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
  }
);

const { data } = await response.json();
data.forEach(model => console.log(model.id));
200 — Success
{
  "data": [
    {"id": "claude-opus-5",   "description": "الأقوى — تفكير متقدم وتحليل معقد",   "context_window": 200000},
    {"id": "claude-fable-5",  "description": "الموديل الأساسي — نافذة سياق 1M توكن",  "context_window": 1000000},
    {"id": "claude-opus-4-8",   "description": "تحليل عميق ومهام معقدة متعددة الخطوات",   "context_window": 200000},
    {"id": "claude-sonnet-4", "description": "أفضل توازن بين السرعة والجودة", "context_window": 200000},
    {"id": "claude-haiku",    "description": "أسرع ردود — مثالي للتطبيقات الفورية",    "context_window": 200000}
  ]
}
إنشاء محادثة
POST /api/v1/chat أرسل رسالة لموديل كلود واستقبل الرد. هذه نقطة الوصول الأساسية لجميع التفاعلات.
model مطلوب
string
الموديل المُستخدم لتوليد الاستجابة.
messages مطلوب
array
مصفوفة كائنات الرسائل تحتوي على role و content.
max_tokens
integer
أقصى عدد tokens في الاستجابة.
temperature
float
يتحكم في العشوائية. 0 = حتمي، 1 = إبداعي.
stream
boolean
تفعيل الاستجابات المتدفقة.
cURL
curl -X POST https://claudemaxhub.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'
Python
import requests

response = requests.post(
    "https://claudemaxhub.com/api/v1/chat",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5",
        "messages": [
            {"role": "user", "content": "Explain quantum computing in simple terms."}
        ],
        "max_tokens": 1024,
        "temperature": 0.7,
    },
)

data = response.json()
print(data["content"][0]["text"])
JavaScript (Node.js / Fetch)
const response = await fetch('https://claudemaxhub.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'claude-opus-5',
    messages: [
      { role: 'user', content: 'Explain quantum computing in simple terms.' },
    ],
    max_tokens: 1024,
    temperature: 0.7,
  }),
});

const data = await response.json();
console.log(data.content[0].text);
PHP (cURL)
$ch = curl_init('https://claudemaxhub.com/api/v1/chat');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model'       => 'claude-opus-5',
        'messages'    => [
            ['role' => 'user', 'content' => 'Explain quantum computing in simple terms.'],
        ],
        'max_tokens'  => 1024,
        'temperature' => 0.7,
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['content'][0]['text'];
Go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "io"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "model": "claude-opus-5",
        "messages": []map[string]string{
            {"role": "user", "content": "Explain quantum computing in simple terms."},
        },
        "max_tokens":  1024,
        "temperature": 0.7,
    })

    req, _ := http.NewRequest("POST",
        "https://claudemaxhub.com/api/v1/chat",
        bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
Ruby
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://claudemaxhub.com/api/v1/chat')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  model: 'claude-opus-5',
  messages: [
    { role: 'user', content: 'Explain quantum computing in simple terms.' }
  ],
  max_tokens: 1024,
  temperature: 0.7
}.to_json

response = http.request(request)
data = JSON.parse(response.body)
puts data['content'][0]['text']
200 — استجابة ناجحة
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [
    {
      "type": "text",
      "text": "Quantum computing uses quantum bits (qubits) that can exist in multiple states simultaneously..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 128
  }
}
id
string
معرّف الرسالة الفريد
model
string
الموديل المُستخدم للاستجابة
content
array
مصفوفة كتل المحتوى (نص)
stop_reason
string
سبب توقف الموديل: end_turn, max_tokens
usage
object
إحصائيات استهلاك التوكنات
معالجة الأخطاء

جميع استجابات الأخطاء المحتملة وكيفية التعامل معها.

حالة HTTP الوصف الحل
401 مفتاح API غير صالح أو مفقود تحقق من مفتاح API في لوحة التحكم
403 الحساب غير مفعّل أو انتهت الفترة التجريبية فعّل حسابك أو جدّد اشتراكك
404 نقطة وصول غير صالحة أو موديل غير موجود تحقق من الرابط واسم الموديل
422 معاملات الطلب غير صالحة راجع صيغة نص الطلب
429 تم تجاوز حد الاستخدام انتظر وأعد المحاولة، أو قلّل تكرار الطلبات
500 خطأ داخلي في الخادم أعد المحاولة بعد بضع ثوانٍ

مستعد للبناء مع كلود ماكس؟

احصل على مفتاح API مجاني مع فترة تجريبية 30 يوم. جميع الـ 5 موديلات مشمولة.