API दस्तावेज़ीकरण

परिचय

Zubnet API आपको टेक्स्ट, इमेज, वीडियो, संगीत, आवाज़, और कोड जनरेशन के लिए 408 AI मॉडल तक प्रोग्रामेटिक एक्सेस देता है। It's fully compatible with the OpenAI API specification — अगर आप पहले से OpenAI का उपयोग कर रहे हैं, तो आप अपना बेस URL और API की बदलकर Zubnet पर स्विच कर सकते हैं।

बेस 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 अनुरोधों को Authorization हेडर में Bearer टोकन के ज़रिए प्रमाणीकरण की आवश्यकता होती है।

Authorization: Bearer YOUR_API_KEY

आप अपने अकाउंट सेटिंग्स। अपनी कीज़ सुरक्षित रखें — वे आपके खाते तक पूरी पहुँच प्रदान करती हैं।

अपनी खुद की प्रोवाइडर कीज़ इस्तेमाल करें (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
  }
}

कोड जनरेशन

प्राकृतिक भाषा प्रॉम्प्ट से कोड जनरेट करें। Server-Sent Events (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..."
    }
  ]
}

असिंक्रोनस मॉडल — 202 Accepted

कुछ मॉडल (FLUX, Runway, Luma, Kling, Leonardo, Vidu, Bria enhance/upscale) असिंक्रोनस रूप से जनरेट करते हैं: वे जॉब स्वीकार करते हैं और कुछ ही क्षणों बाद उसे पूरा करते हैं। इनके लिए एंडपॉइंट इमेज के बजाय एक पोल हैंडल के साथ 202 Accepted देता है — OpenAI कॉन्ट्रैक्ट का एक जानबूझकर किया गया विस्तार, जिसमें ऐसा कोई रूट नहीं है:

{
  "id": "01934f2e-7c1b-7e55-9f3a-2d1c0b4a8f66",
  "status": "queued",
  "poll": "/v1/images/01934f2e-7c1b-7e55-9f3a-2d1c0b4a8f66"
}

असिंक्रोनस रूप से शुरू किए गए जनरेशन को पोल करें। queued, processing, completed या failedरिपोर्ट करता है; पूरा होने पर इमेज URL सिंक प्रतिक्रिया जैसे ही data आकार में दिखाई देता है। कॉल करने वाली API कुंजी के वर्कस्पेस तक सीमित — जो id मौजूद नहीं है या किसी अन्य वर्कस्पेस की है, वह वही 404.

{
  "id": "01934f2e-7c1b-7e55-9f3a-2d1c0b4a8f66",
  "status": "completed",
  "created": 1699900000,
  "data": [
    {
      "url": "https://zubnet.com/files/abc123.png"
    }
  ]
}

टेक्स्ट प्रॉम्प्ट से इमेज संपादित करें — OpenAI का images.edit कॉन्ट्रैक्ट, multipart/form-dataके रूप में भेजा जाता है। उन मॉडलों पर उपलब्ध जो इनपुट इमेज स्वीकार करते हैं (उनके मॉडल कार्ड में इमेज एडिटिंग सूचीबद्ध है): gpt-image-2.5-sunburst, gpt-image-2.5-flare, gpt-image-2, p-image-edit, gen4_image, luma/photon-1 और अन्य। कोई भी अन्य मॉडल 400देता है। सिंक्रोनस और असिंक्रोनस मॉडल जनरेशन जैसे ही 200 / 202 कॉन्ट्रैक्ट का पालन करते हैं।

फ़ॉर्म फ़ील्ड

उदाहरण अनुरोध

curl https://api.zubnet.com/v1/images/edits \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "prompt=Turn the sky into a starry night, keep everything else" \
  -F "image=@photo.png"

{
  "created": 1699900000,
  "data": [
    {
      "url": "https://zubnet.com/files/def456.png",
      "revised_prompt": "Turn the sky into a starry night, keep everything else"
    }
  ]
}

वीडियो जनरेशन

टेक्स्ट प्रॉम्प्ट या इमेज से वीडियो जनरेट करें। टेक्स्ट-टू-वीडियो, इमेज-टू-वीडियो, और वीडियो-टू-वीडियो वर्कफ़्लो सपोर्ट करता है।

उपलब्ध मॉडल

रिक्वेस्ट बॉडी

उदाहरण: टेक्स्ट-टू-वीडियो

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"
}

वीडियो अंडरस्टैंडिंग

AI का उपयोग करके वीडियो कंटेंट का विश्लेषण करें। विश्लेषण के लिए वीडियो URL सबमिट करें और परिणामों के लिए पोल करें। मल्टीple analysis types.

AI विश्लेषण के लिए वीडियो सबमिट करें। एक जॉब ID मिलती है जिसे आप परिणामों के लिए पोल कर सकते हैं।

रिक्वेस्ट बॉडी

उदाहरण अनुरोध

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) के लिए नॉलेज बेस बनाएँ और प्रबंधित करें। Upload documents (PDF, DOCX, TXT, Markdown) or add web URLs and raw text, then query them in your chat completions.

नया नॉलेज बेस बनाएँ।

रिक्वेस्ट बॉडी

उदाहरण: एक नॉलेज बेस बनाएँ

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..."
  }'

नॉलेज बेस के सभी दस्तावेज़ सूचीबद्ध करें।

नॉलेज बेस से एक विशिष्ट दस्तावेज़ हटाएं।

किसी विशिष्ट दस्तावेज़ की एक्सट्रैक्ट की गई टेक्स्ट सामग्री पढ़ें।

रीरैंकिंग

क्वेरी के अनुसार डॉक्यूमेंट्स की सूची को प्रासंगिकता के आधार पर रीरैंक करें। Useful for improving search results, RAG pipelines, and recommendation systems.

उपलब्ध मॉडल

रिक्वेस्ट बॉडी

उदाहरण अनुरोध

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"
}

लाइब्रेरी

लाइब्रेरी वह जगह है जहाँ सभी जनरेट किया गया कंटेंट रहता है — इमेज, वीडियो, कंपोज़िशन, कोड दस्तावेज़, ट्रांसक्रिप्शन, और भी बहुत कुछ। इसका उपयोग आइटम सूचीबद्ध करने, एसिंक जनरेशन स्थिति जाँचने, मेटाडेटा अपडेट करने और अपने कंटेंट को प्रबंधित करने के लिए करें।

अपनी लाइब्रेरी के आइटम कंटेंट प्रकार के अनुसार सूचीबद्ध करें।

कंटेंट टाइप्स

Query पैरामीटर

{
  "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"
    },
    ...
  ]
}

ID के आधार पर एक एकल लाइब्रेरी आइटम प्राप्त करें। यह इसके लिए प्राथमिक एंडपॉइंट है एसिंक जनरेशन स्थिति की पोलिंग.

जनरेशन स्टेट्स

पोलिंग पैटर्न

# 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 फ़िल्टर लिस्ट एंडपॉइंट के समान।

असिस्टेंट्स

असिस्टेंट्स पुन: उपयोग योग्य चैट प्रीसेट हैं with a custom name, model, system prompt, and settings. Use them to create specialized AI personas for different tasks.

नया असिस्टेंट बनाएँ।

अपनी वर्कस्पेस में सभी असिस्टेंट सूचीबद्ध करें।

असिस्टेंट का कॉन्फ़िगरेशन अपडेट करें (नाम, मॉडल, सिस्टम प्रॉम्प्ट, सेटिंग्स)।

एक असिस्टेंट हटाएँ।

MCP स्टोर

MCP (Model Context Protocol) सर्वर ब्राउज़ करें और एक्टिवेट करें to give your agents extended tool capabilities — वेब सर्च और डेटा एक्सेस से लेकर कोड एक्ज़ीक्यूशन और थर्ड-पार्टी इंटीग्रेशन तक।

MCP सर्वर कैटलॉग ब्राउज़ करें।

Query पैरामीटर

{
  "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 सर्वर निष्क्रिय करें।

एजेंट्स

ऑटोनोमस AI एजेंट्स बनाएँ और प्रबंधित करें that operate across communication channels. Agents can respond to messages on Telegram and Discord, run on scheduled triggers, and leverage knowledge bases and MCP servers for extended capabilities.

नया एजेंट बनाएँ।

रिक्वेस्ट बॉडी

उदाहरण अनुरोध

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
    }
  ]
}

एजेंट चैनल्स

एजेंट्स को कम्युनिकेशन प्लेटफ़ॉर्म से जोड़ें। Each agent supports one channel per type (one Telegram bot, one Discord bot).

एजेंट में एक कम्युनिकेशन चैनल जोड़ें।

रिक्वेस्ट बॉडी

उदाहरण अनुरोध

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
}

किसी एजेंट से जुड़े सभी चैनल सूचीबद्ध करें।

किसी एजेंट से एक चैनल हटाएँ।

एजेंट ट्रिगर्स

ट्रिगर्स से एजेंट एक्शन ऑटोमेट करें। Scheduled triggers use cron expressions to run at specific times; event triggers fire in response to external events.

एजेंट के लिए एक स्वचालित ट्रिगर बनाएं।

रिक्वेस्ट बॉडी

उदाहरण: डेली समरी ट्रिगर

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 पर सेट करें।

एक ट्रिगर हटाएँ।

वर्कस्पेस

वर्कस्पेस आपकी टीम की संगठनात्मक इकाई है। Each workspace has its own credit balance, subscription, API keys, and members. Manage workspaces, invite team members, and track usage.

नया वर्कस्पेस बनाएँ।

{
  "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 लंबित आमंत्रण।

लंबित आमंत्रण रद्द करें।

वर्कस्पेस से किसी सदस्य को हटाएँ, या अपनी स्वयं की यूज़र ID का उपयोग करके वर्कस्पेस छोड़ें।

वर्कस्पेस के लिए संचित उपयोग आँकड़े सूचीबद्ध करें। कर्सर-आधारित पेजिनेशन समर्थित है।

आइटमवार उपयोग प्रविष्टियाँ सूचीबद्ध करें (लागत सहित पूर्ण लाइब्रेरी आइटम > 0)। प्रत्येक प्रविष्टि में प्रकार, मॉडल, शीर्षक, लागत, और टाइमस्टैंप शामिल है।

उपयोग आइटम्स की कुल गिनती प्राप्त करें।

बातचीत

बातचीत चैट संदेशों को सेशन में समूहित करती है। Create a conversation first, then send messages to it. Conversations can also be managed through the लाइब्रेरी API का उपयोग करके conversations कंटेंट टाइप।

एक नई बातचीत बनाएं। यह खाली संदेश सूची के साथ बातचीत ऑब्जेक्ट लौटाता है।

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

किसी बातचीत में संदेश भेजें और Server-Sent Events (SSE) के माध्यम से AI प्रतिक्रिया प्राप्त करें। देखें चैट कम्प्लीशन 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..."
}

बिलिंग

उपलब्ध प्लान ब्राउज़ करें, ऑर्डर हिस्ट्री देखें, initiate checkout, and manage subscriptions.

उपलब्ध सब्सक्रिप्शन प्लान सूचीबद्ध करें।

वर्तमान वर्कस्पेस के ऑर्डर सूचीबद्ध करें। कर्सर-आधारित पेजिनेशन समर्थित है।

किसी सब्सक्रिप्शन प्लान या क्रेडिट खरीद के लिए चेकआउट शुरू करें। इसके लिए वर्कस्पेस मैनेज अनुमति आवश्यक है।

वर्तमान वर्कस्पेस सदस्यता रद्द करें। इसके लिए वर्कस्पेस प्रबंधन अनुमति आवश्यक है।

कंटेंट रिपोर्ट

अनुचित या नीति-उल्लंघन कंटेंट की रिपोर्ट करें in the public library.

कंटेंट रिपोर्ट सबमिट करें। प्रत्येक यूज़र किसी दिए गए आइटम की रिपोर्ट केवल एक बार कर सकता है।

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

और एंडपॉइंट

पूरा API ऊपर के अनुभागों से बड़ा है। ये एंडपॉइंट लाइव हैं और वही ऑथेंटिकेशन इस्तेमाल करते हैं:

एरर्स

API मानक HTTP स्टेटस कोड इस्तेमाल करता है और विस्तृत एरर मैसेज लौटाता है।

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

रेट लिमिट

रेट लिमिट प्लान के अनुसार बदलती है। हर रिस्पॉन्स में हेडर शामिल होते हैं:

अगर आप रेट लिमिट पर पहुँच जाएँ, तो रीसेट टाइम तक इंतज़ार करें या अपनी लिमिट बढ़ाने के लिए हमसे संपर्क करें।