وثائق API

مقدمة

يمنحك Zubnet API إمكانية الوصول البرمجي إلى 408 نموذج ذكاء اصطناعي لإنشاء النصوص والصور والفيديو والموسيقى والصوت والشيفرة. وتتوافق الواجهة بالكامل مع مواصفات OpenAI API — إذا كنت تستخدم OpenAI بالفعل، فيمكنك الانتقال إلى Zubnet بتغيير عنوان URL الأساسي ومفتاح API.

قاعدة URL

https://api.zubnet.com/v1

بداية سريعة

# Using curl
curl https://api.zubnet.com/v1/chat/completions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# Using Python with OpenAI SDK
from openai import OpenAI

client = OpenAI(
    api_key="your-zubnet-api-key",
    base_url="https://api.zubnet.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

المصادقة

تتطلب جميع طلبات API المصادقة باستخدام رمز Bearer في ترويسة Authorization.

Authorization: Bearer YOUR_API_KEY

يمكنك إنشاء مفاتيح API من إعدادات الحساب. حافظ على مفاتيحك آمنة — فهي تمنح وصولًا كاملًا إلى حسابك.

استخدام مفاتيح الموفر الخاصة بك (BYOK)

يمكنك استخدام مفاتيح API الخاصة بك لدى المزوّدين المدعومين. أضفها في إعدادات مساحة العمل، وستُستخدم تلقائيًا للطلبات الموجّهة إلى أولئك المزوّدين — من دون أي هامش إضافي. يتوفر BYOK في الخطط التي تدعمه.

عند إعداد مفتاح BYOK لأحد المزوّدين، تكون له الأولوية على مفتاح المنصة. ولا يلزم تغيير طلبات API — إذ تُختار المفاتيح تلقائيًا وبصورة شفافة تمامًا.

مزوّدو BYOK المدعومون

النماذج

قائمة بجميع النماذج المتاحة.

curl https://api.zubnet.com/v1/models \
  -H "Authorization: Bearer $ZUBNET_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-5",
      "object": "model",
      "created": 1699900000,
      "owned_by": "anthropic"
    },
    {
      "id": "deepseek-chat",
      "object": "model",
      "created": 1699900000,
      "owned_by": "deepseek"
    },
    ...
  ]
}

استكمالات الدردشة

إنشاء استكمال الدردشة. هذه هي نقطة النهاية الأساسية لإنشاء النص، وهي متوافقة مع تنسيق إكمال الدردشة OpenAI.

نص الطلب

مثال على الطلب

curl https://api.zubnet.com/v1/chat/completions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the capital of France?"}
    ],
    "temperature": 0.7,
    "max_tokens": 150
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1699900000,
  "model": "claude-sonnet-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}

إنشاء الشيفرة

أنشئ شيفرة من تعليمات بلغة طبيعية، واحصل على استجابة متدفقة عبر الأحداث المرسلة من الخادم (SSE).

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/ai/completions/code \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A function that checks if a number is prime",
    "language": "python"
  }'

{
  "object": "code_document",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "claude-sonnet-5",
  "cost": 1,
  "title": "Prime Number Checker",
  "content": "def is_prime(n): ..."
}

توليد الصور

أنشئ صورًا من تعليمات نصية باستخدام نماذج FLUX وStable Diffusion وIdeogram وغيرها.

النماذج المتاحة

نص الطلب

مثال على الطلب

curl https://api.zubnet.com/v1/images/generations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro-1.1-ultra",
    "prompt": "A serene mountain lake at sunset, photorealistic",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1699900000,
  "data": [
    {
      "url": "https://zubnet.com/files/abc123.png",
      "revised_prompt": "A serene mountain lake..."
    }
  ]
}

توليد الفيديو

أنشئ مقاطع فيديو من تعليمات نصية أو صور. تدعم نقطة النهاية التحويل من النص إلى فيديو، ومن الصورة إلى فيديو، ومن فيديو إلى فيديو.

النماذج المتاحة

نص الطلب

مثال: تحويل النص إلى فيديو

curl https://zubnet.com/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A drone shot flying over a coral reef at golden hour",
    "aspect_ratio": "16:9",
    "duration": 8
  }'

مثال: صورة إلى فيديو

curl https://zubnet.com/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=kling-v2-5-turbo" \
  -F "prompt=Camera slowly zooms in" \
  -F "frames=@my-image.png"

{
  "object": "video",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-generate-001",
  "state": "processing",
  "progress": 0,
  "cost": 5,
  "output_file": null,
  "created_at": "2026-02-25T12:00:00Z"
}

فهم الفيديو

حلّل محتوى الفيديو بالذكاء الاصطناعي. أرسل عنوان URL للفيديو ثم استعلم عن النتائج. تدعم نقطة النهاية أنواعًا متعددة من التحليل.

أرسل فيديو لتحليله بالذكاء الاصطناعي. تعيد نقطة النهاية معرّف مهمة يمكنك استخدامه للاستعلام عن النتائج.

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/ai/video-understanding \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "type": "summary"
  }'

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}

التحقق من حالة مهمة تحليل الفيديو.

{
  "status": "completed",
  "result": {
    "type": "summary",
    "content": "The video shows a product demonstration..."
  }
}

التأليف الموسيقي

قم بإنشاء موسيقى أصلية من أوصاف النص أو كلمات الأغاني أو علامات النمط.

النماذج المتاحة

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/ai/compositions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v5",
    "prompt": "An upbeat synthwave track about coding at 3am",
    "tags": "synthwave, electronic, upbeat",
    "instrumental": true
  }'

[
  {
    "object": "composition",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "model": "suno/v5",
    "title": "Midnight Code",
    "tags": "synthwave, electronic, upbeat",
    "cost": 2,
    "output_file": {
      "url": "https://zubnet.com/files/abc123.mp3"
    }
  },
  {
    "object": "composition",
    "id": "550e8400-e29b-41d4-a716-446655440001",
    // ... second variant
  }
]

المؤثرات الصوتية

إنشاء مؤثرات صوتية من أوصاف النص.

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/ai/sound-effects \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sound-effect-model",
    "prompt": "Thunder rumbling in the distance followed by heavy rain"
  }'

{
  "object": "sound_effect",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "sound-effect-model",
  "cost": 1,
  "output_file": {
    "url": "https://zubnet.com/files/abc123.mp3"
  }
}

تحويل النص إلى كلام

قم بتحويل النص إلى صوت كلام طبيعي باستخدام أصوات من ElevenLabs وCartesia وSpeechify والمزيد.

مثال على الطلب

curl https://api.zubnet.com/v1/audio/speech \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1-hd",
    "input": "Welcome to Zubnet, the future of AI.",
    "voice": "nova"
  }' --output speech.mp3

النسخ

نسخ الصوت إلى نص.

مثال على الطلب

curl https://api.zubnet.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=whisper-1" \
  -F "file=@recording.mp3"

{
  "object": "transcription",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "whisper-1",
  "content": "Hello, this is a test recording..."
}

عزل الصوت

استخراج غناء نظيف من الصوت، وإزالة الضوضاء الخلفية والموسيقى. مدعوم من ElevenLabs.

مثال على الطلب

curl https://zubnet.com/api/ai/isolated-voices \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@noisy-recording.mp3"

{
  "object": "isolated_voice",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 1,
  "input_file": {
    "url": "https://zubnet.com/files/input.mp3"
  },
  "output_file": {
    "url": "https://zubnet.com/files/isolated.mp3"
  }
}

فصل المسارات الصوتية

فصل الصوت إلى مقاطع فردية (غناء، طبول، باس، جيتار، بيانو، أخرى). مدعوم من ElevenLabs.

مثال على الطلب

curl https://zubnet.com/api/ai/stem-separations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@song.mp3"

{
  "object": "stem_separation",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 1,
  "input_file": {
    "url": "https://zubnet.com/files/song.mp3"
  },
  "output_file": {
    "url": "https://zubnet.com/files/stems.zip"
  }
}

أصوات

إنشاء وإدارة الأصوات المخصصة لإنشاء تحويل النص إلى كلام.

أنشئ صوتًا مخصصًا عن طريق تحميل عينات صوتية.

قم بإدراج جميع الأصوات المتوفرة في مساحة العمل الخاصة بك، بما في ذلك الأصوات المخصصة التي قمت بإنشائها.

تحديث صوت مخصص (الاسم، الإعدادات).

حذف صوت مخصص.

التضمين

إنشاء تضمينات نصية للبحث الدلالي والتشابه.

مثال على الطلب

curl https://api.zubnet.com/v1/embeddings \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

قواعد المعرفة

أنشئ قواعد معرفة وأدِرها للتوليد المعزّز بالاسترجاع (RAG). ارفع مستندات PDF أو DOCX أو TXT أو Markdown، أو أضف روابط ويب ونصوصًا، ثم استعلم عنها في محادثاتك.

إنشاء قاعدة معرفية جديدة.

نص الطلب

مثال: إنشاء قاعدة معارف

curl https://zubnet.com/api/knowledge-bases \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My KB",
    "description": "Optional description"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My KB",
  "description": "Optional description",
  "status": "active"
}

قم بإدراج جميع قواعد المعرفة في مساحة العمل الخاصة بك.

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My KB",
    "description": "Optional description",
    "status": "active"
  },
  ...
]

احصل على تفاصيل حول قاعدة معرفية محددة، بما في ذلك وثائقها.

حذف قاعدة المعرفة وجميع وثائقها.

استيعاب وثيقة في قاعدة المعرفة. يدعم تحميل الملفات وعناوين URL والنص الخام.

نص الطلب

مثال: استيعاب ملف

curl https://zubnet.com/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@report.pdf"

مثال: استيعاب URL

curl https://zubnet.com/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Zubnet Docs",
    "type": "url",
    "url": "https://zubnet.com/developers.html"
  }'

مثال: استيعاب النص الخام

curl https://zubnet.com/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Company Policy",
    "type": "text",
    "content": "All employees must complete security training annually..."
  }'

قم بإدراج جميع المستندات في قاعدة المعرفة.

حذف مستند محدد من قاعدة المعرفة.

قراءة محتوى النص المستخرج من وثيقة معينة.

إعادة الترتيب

أعد ترتيب قائمة المستندات وفق صلتها بالاستعلام. يفيد ذلك في تحسين نتائج البحث ومسارات عمل RAG وأنظمة التوصية.

النماذج المتاحة

نص الطلب

مثال على الطلب

curl https://api.zubnet.com/v1/reranking \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-v4.0-pro",
    "query": "How do I reset my password?",
    "documents": [
      "To reset your password, go to Settings > Security > Change Password.",
      "Our pricing plans start at $9/month for individuals.",
      "Password requirements: minimum 8 characters, one uppercase letter.",
      "Contact support at help@example.com for account issues."
    ],
    "top_n": 3
  }'

{
  "object": "list",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.953
    },
    {
      "index": 2,
      "relevance_score": 0.714
    },
    {
      "index": 3,
      "relevance_score": 0.389
    }
  ],
  "model": "rerank-v4.0-pro"
}

مكتبة

تضم المكتبة كل المحتوى المُنشأ — الصور والفيديو والمقطوعات الموسيقية ومستندات الشيفرة والنصوص المنسوخة وغير ذلك. استخدمها لعرض العناصر والتحقق من حالة الإنشاء غير المتزامن وتحديث البيانات الوصفية وإدارة محتواك.

قم بإدراج العناصر الموجودة في مكتبتك حسب نوع المحتوى.

أنواع المحتوى

معلمات الاستعلام

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "object": "video",
      "model": "veo-3.1-generate-001",
      "title": "Coral reef drone shot",
      "state": 3,
      "progress": 100,
      "cost": 5,
      "output_file": {
        "url": "https://zubnet.com/files/abc123.mp4",
        "size": 8421376,
        "extension": "mp4"
      },
      "created_at": "2026-03-01T12:00:00Z"
    },
    ...
  ]
}

استرد عنصرًا واحدًا من المكتبة حسب معرّفه. هذه هي نقطة النهاية الأساسية من أجل الاستعلام عن حالة الإنشاء غير المتزامن.

دول الجيل

نمط الاقتراع

# 1. Start async generation
curl -X POST https://zubnet.com/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1-generate-001", "prompt": "A coral reef"}'
# Returns: {"id": "550e8400-...", "state": 1, ...}

# 2. Poll for completion
curl https://zubnet.com/api/library/videos/550e8400-... \
  -H "Authorization: Bearer $ZUBNET_API_KEY"
# Returns: {"state": 2, "progress": 45, ...}  (still processing)
# Returns: {"state": 3, "progress": 100, "output_file": {"url": "..."}}  (done!)

تحديث البيانات التعريفية لعنصر المكتبة.

حذف عنصر مكتبة والملفات المرتبطة به.

استرد العدد الإجمالي لعناصر نوع محتوى معيّن. تدعم نقطة النهاية مرشحَي query و model نفسهما اللذين تدعمهما نقطة نهاية القائمة.

مساعدين

المساعدون عبارة عن إعدادات مسبقة للدردشة قابلة لإعادة الاستخدام مع اسم ونموذج وموجه نظام وإعدادات مخصصة. استخدمها لإنشاء شخصيات ذكاء اصطناعي متخصصة لمهام مختلفة.

إنشاء مساعد جديد.

قم بإدراج كافة المساعدين في مساحة العمل الخاصة بك.

قم بتحديث تكوين المساعد (الاسم والطراز وموجه النظام والإعدادات).

حذف مساعد.

متجر MCP

تصفح وتنشيط خوادم MCP (نموذج سياق البروتوكول) لمنح وكلائك إمكانات أدوات موسعة — بدءًا من بحث الويب والوصول إلى البيانات وحتى تنفيذ التعليمات البرمجية وتكاملات الجهات الخارجية.

تصفح كتالوج خادم MCP.

معلمات الاستعلام

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "name": "GitHub",
      "description": "Access GitHub repositories, issues, and pull requests",
      "category": "developer",
      "config_schema": [
        {"name": "api_key", "type": "secret", "label": "API Key", "required": true}
      ],
      "tools": ["list_repos", "create_issue", "search_code"],
      "is_official": true
    },
    ...
  ]
}

نشّط خادم MCP لمساحة عملك، وقدّم قيم الإعداد، مثل مفاتيح API، وفق config_schema.

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/mcp-store/activations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server_id": "550e8400-e29b-41d4-a716-446655440000",
    "config": {
      "api_key": "ghp_xxxxxxxxxxxx"
    }
  }'

{
  "id": "act-uuid-...",
  "server_id": "550e8400-...",
  "status": 1,
  "config": {
    "api_key": "••••••••"
  },
  "server": {
    "name": "GitHub",
    ...
  },
  "created_at": "2026-03-01T12:00:00Z"
}

قم بإدراج جميع خوادم MCP التي تم تنشيطها في مساحة العمل الخاصة بك.

قم بتحديث تكوين التنشيط أو حالته.

قم بإلغاء تنشيط خادم MCP من مساحة العمل الخاصة بك.

الوكلاء

إنشاء وإدارة وكلاء الذكاء الاصطناعي المستقلين الذين يعملون عبر قنوات الاتصال. يمكن للوكلاء الرد على الرسائل الموجودة على Telegram وDiscord، والتشغيل على المشغلات المجدولة، والاستفادة من قواعد المعرفة وخوادم MCP للحصول على إمكانات موسعة.

إنشاء وكيل جديد.

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/agents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Bot",
    "model": "claude-sonnet-5",
    "system_prompt": "You are a friendly support agent. Answer questions clearly and concisely.",
    "mode": "advanced"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Support Bot",
  "slug": "support-bot",
  "avatar": null,
  "model": "claude-sonnet-5",
  "system_prompt": "You are a friendly support agent...",
  "status": 1,
  "mode": "advanced",
  "permissions": {
    "time_windows": [],
    "frequency_cap": {
      "max_messages_per_hour": 60,
      "max_messages_per_day": 500
    },
    "channel_preferences": {},
    "allowed_actions": {
      "can_use_tools": true,
      "can_access_kb": true,
      "max_tool_calls_per_message": 5
    }
  },
  "cost": 0,
  "last_active_at": null,
  "created_at": 1709136000,
  "updated_at": null,
  "user": {
    "id": "a1b2c3d4-...",
    "first_name": "Jane",
    "last_name": "Doe",
    "avatar": "https://zubnet.com/files/avatar.jpg"
  },
  "channels": []
}

قم بإدراج كافة الوكلاء في مساحة العمل. يدعم ترقيم الصفحات والتصفية.

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "name": "Support Bot",
      "slug": "support-bot",
      "model": "claude-sonnet-5",
      "status": 1,
      "mode": "advanced",
      "cost": 12.50,
      "last_active_at": 1709222400,
      "created_at": 1709136000,
      ...
    }
  ]
}

احصل على التفاصيل الكاملة لوكيل معين، بما في ذلك قنواته وخوادم MCP المرتبطة وقواعد المعرفة.

تحديث وكيل. جميع الحقول اختيارية — يتم تغيير الحقول المتوفرة فقط.

نص الطلب

كائن الأذونات

{
  "permissions": {
    "time_windows": [
      {
        "days": [1, 2, 3, 4, 5],  // 0=Sun, 6=Sat
        "timezone": "America/New_York",
        "start_hour": 9,            // 0-23
        "end_hour": 17              // 1-24
      }
    ],
    "frequency_cap": {
      "max_messages_per_hour": 60,    // 1-1000
      "max_messages_per_day": 500     // 1-10000
    },
    "channel_preferences": {
      "default_channel": "telegram",
      "proactive_channels": ["telegram", "discord"]
    },
    "allowed_actions": {
      "can_use_tools": true,
      "can_access_kb": true,
      "max_tool_calls_per_message": 5  // 0-50
    }
  }
}

حذف وكيل. يؤدي هذا أيضًا إلى إزالة جميع القنوات والمشغلات والرسائل والتكاملات.

التكامل

اربط قاعدة معرفة بوكيل للحصول على استجابات معزّزة بالاسترجاع (RAG). نص الطلب: { "knowledge_base_id": "uuid" }

قم بإلغاء ربط قاعدة المعرفة بالوكيل.

اربط خادم MCP بوكيل لتوسيع الأدوات المتاحة له. متن الطلب: { "activation_id": "uuid" }

قم بإلغاء ربط خادم MCP من الوكيل.

استرداد سجل المحادثة للوكيل.

{
  "object": "list",
  "data": [
    {
      "id": "msg-uuid-...",
      "direction": "inbound",
      "content": "How do I reset my password?",
      "external_user_name": "john_doe",
      "cost": 0,
      "model": null,
      "created_at": 1709222400
    },
    {
      "id": "msg-uuid-...",
      "direction": "outbound",
      "content": "Go to Settings > Security > Change Password...",
      "cost": 0.25,
      "model": "claude-sonnet-5",
      "created_at": 1709222401
    }
  ]
}

قنوات الوكيل

ربط الوكلاء بمنصات الاتصالات. يدعم كل وكيل قناة واحدة لكل نوع (روبوت Telegram واحد، وروبوت Discord واحد).

إضافة قناة اتصال إلى وكيل.

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/agents/550e8400-.../channels \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "telegram",
    "token": "7123456789:AAH..."
  }'

{
  "id": "ch-uuid-...",
  "type": "telegram",
  "status": 1,
  "metadata": {},
  "last_error": null,
  "last_message_at": null,
  "created_at": 1709136000
}

قم بإدراج جميع القنوات المتصلة بالوكيل.

إزالة قناة من وكيل.

مشغلات الوكيل

أتمت إجراءات الوكيل باستخدام المشغّلات. تستخدم المشغّلات المجدولة تعبيرات cron للعمل في أوقات محددة، بينما تعمل مشغّلات الأحداث استجابةً لأحداث خارجية.

إنشاء مشغل تلقائي للوكيل.

نص الطلب

مثال: مشغل الملخص اليومي

curl https://zubnet.com/api/agents/550e8400-.../triggers \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Summary",
    "type": "scheduled",
    "prompt": "Summarize the key metrics for today and send them to the team.",
    "cron_expression": "0 18 * * 1-5",
    "timezone": "America/New_York"
  }'

{
  "id": "tr-uuid-...",
  "name": "Daily Summary",
  "type": "scheduled",
  "status": 1,
  "cron_expression": "0 18 * * 1-5",
  "timezone": "America/New_York",
  "prompt": "Summarize the key metrics for today...",
  "channel_id": null,
  "last_run_at": null,
  "next_run_at": 1709236800,
  "run_count": 0,
  "created_at": 1709136000
}

قم بإدراج كافة المشغلات للوكيل.

تحديث الزناد. جميع الحقول اختيارية. تعيين status إلى 0 للتعطيل أو 1 للتمكين.

حذف الزناد.

مساحات العمل

مساحات العمل هي الوحدة التنظيمية لفريقك. تحتوي كل مساحة عمل على رصيدها الائتماني والاشتراك ومفاتيح API والأعضاء. إدارة مساحات العمل، ودعوة أعضاء الفريق، وتتبع الاستخدام.

إنشاء مساحة عمل جديدة.

{
  "id": "550e8400-...",
  "name": "My Team",
  "subscription": null,
  "api_spending_limit": null,
  "api_spending_current": 0,
  "owner": { "id": "...", "email": "..." },
  "created_at": "2026-03-01T12:00:00Z"
}

قم بتحديث إعدادات مساحة العمل. يتطلب إذن إدارة مساحة العمل.

حذف مساحة عمل. يتطلب إذن إدارة مساحة العمل.

قم بدعوة مستخدم للانضمام إلى مساحة العمل عبر البريد الإلكتروني. الحد الأقصى 20 دعوة معلقة لكل مساحة عمل.

إلغاء دعوة معلقة.

أزل عضوًا من مساحة العمل، أو غادرها باستخدام معرّف المستخدم الخاص بك.

سرد إحصائيات الاستخدام المجمعة لمساحة العمل. يدعم ترقيم الصفحات على أساس المؤشر.

قم بإدراج إدخالات الاستخدام المفصلة (عناصر المكتبة المكتملة مع التكلفة > 0). يتضمن كل إدخال النوع والنموذج والعنوان والتكلفة والطابع الزمني.

احصل على العدد الإجمالي لعناصر الاستخدام.

المحادثات

تقوم المحادثات بتجميع رسائل الدردشة في جلسات. أنشئ محادثة أولاً، ثم أرسل رسائل إليها. يمكن أيضًا إدارة المحادثات من خلال مكتبة API باستخدام conversations نوع المحتوى.

أنشئ محادثة جديدة. تعيد نقطة النهاية كائن المحادثة مع قائمة رسائل فارغة.

{
  "object": "conversation",
  "id": "550e8400-...",
  "title": null,
  "cost": 0,
  "messages": [],
  "created_at": "2026-03-01T12:00:00Z"
}

أرسل رسالة إلى محادثة واحصل على استجابة الذكاء الاصطناعي عبر الأحداث المرسلة من الخادم (SSE). انظر استكمالات الدردشة قسم تفاصيل تنسيق الحدث SSE.

نص الطلب

مثال على الطلب

curl https://zubnet.com/api/ai/conversations/550e8400-.../messages \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "content": "Explain quantum computing in simple terms"
  }'

الحساب

أدر ملفك الشخصي وأنشئ مفاتيح API برمجيًا.

قم بتحديث معلومات ملفك الشخصي.

قم بإنشاء مفتاح API جديد. يتطلب تأكيد كلمة المرور للأمان. يتم إرجاع مفتاح API الكامل مرة واحدة فقط في هذا الرد — قم بتخزينه بشكل آمن.

{
  "id": "550e8400-...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "api_key": "zub_live_a1b2c3d4e5f6..."
}

الفواتير

تصفح الخطط المتاحة، وعرض سجل الطلبات، وبدء الخروج، وإدارة الاشتراكات.

قائمة خطط الاشتراك المتاحة.

قائمة الطلبات لمساحة العمل الحالية. يدعم ترقيم الصفحات على أساس المؤشر.

ابدأ عملية الدفع لخطة الاشتراك أو شراء الرصيد. يتطلب إذن إدارة مساحة العمل.

إلغاء الاشتراك الحالي في مساحة العمل. يتطلب إذن إدارة مساحة العمل.

تقارير المحتوى

الإبلاغ عن المحتوى غير المناسب أو المخالف للسياسة في المكتبة العامة.

إرسال تقرير المحتوى. يمكن لكل مستخدم الإبلاغ عن عنصر معين مرة واحدة فقط.

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

المزيد من نقاط النهاية

السطح الكامل أكبر من الأقسام المذكورة أعلاه. نقاط النهاية هذه حية وتستخدم نفس المصادقة:

أخطاء

تستخدم واجهة API رموز حالة HTTP القياسية وتعيد رسائل خطأ مفصّلة.

{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

حدود المعدل

تختلف حدود الأسعار حسب الخطة. يتم تضمين العناوين في كل رد:

إذا بلغت حدّ المعدل، فانتظر حتى موعد إعادة الضبط أو تواصل معنا لزيادة حدودك.