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

परिचय

Zubnet API आपको टेक्स्ट, इमेज, वीडियो, संगीत, आवाज़, और कोड जनरेशन के लिए 361 AI मॉडल तक प्रोग्रामेटिक एक्सेस देता है। It's fully compatible with the OpenAI API specification — if you're already using OpenAI, you can switch to Zubnet by changing your base URL and API key.

बेस 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-4-20250514",
    "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-4-20250514",
    messages=[{"role": "user", "content": "Hello!"}]
)

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

प्रमाणीकरण

सभी API अनुरोधों को Authorization हेडर में Bearer टोकन के ज़रिए प्रमाणीकरण की आवश्यकता होती है।

Authorization: Bearer YOUR_API_KEY

आप अपने account settings. Keep your keys secure — they grant full access to your account.

अपनी खुद की प्रोवाइडर कीज़ इस्तेमाल करें (BYOK)

You can use your own API keys from supported providers. Add them in your workspace settings and they'll be used automatically for requests to those providers — at zero markup. BYOK is available on plans that support it.

When a BYOK key is configured for a provider, it takes priority over the platform key. No changes are needed to your API requests — the key resolution is fully transparent.

समर्थित BYOK प्रोवाइडर

मॉडल

सभी उपलब्ध मॉडल सूचीबद्ध करें।

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

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-20250514",
      "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-4-20250514",
    "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-4-20250514",
  "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-4-20250514",
  "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://cdn.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"
}

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

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://cdn.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://cdn.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://cdn.zubnet.com/files/input.mp3"
  },
  "output_file": {
    "url": "https://cdn.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://cdn.zubnet.com/files/song.mp3"
  },
  "output_file": {
    "url": "https://cdn.zubnet.com/files/stems.zip"
  }
}

Voices

टेक्स्ट-टू-स्पीच जनरेशन के लिए कस्टम आवाज़ें बनाएँ और प्रबंधित करें।

ऑडियो सैंपल अपलोड करके कस्टम आवाज़ बनाएँ।

अपनी वर्कस्पेस में उपलब्ध सभी आवाज़ें सूचीबद्ध करें, जिसमें आपकी बनाई कस्टम आवाज़ें शामिल हैं।

कस्टम आवाज़ अपडेट करें (नाम, सेटिंग्स)।

कस्टम आवाज़ हटाएँ।

एम्बेडिंग

सिमैंटिक सर्च और समानता के लिए टेक्स्ट एम्बेडिंग्स बनाएँ।

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

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.

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

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

Example: Create a Knowledge Base

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

List all knowledge bases in your workspace.

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

Get details of a specific knowledge base, including its documents.

Delete a knowledge base and all its documents.

Ingest a document into a knowledge base. Supports file uploads, URLs, and raw text.

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

Example: Ingest a File

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

Example: Ingest a 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"
  }'

Example: Ingest Raw Text

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

List all documents in a knowledge base.

Delete a specific document from a knowledge base.

Read the extracted text content of a specific document.

रीरैंकिंग

क्वेरी के अनुसार डॉक्यूमेंट्स की सूची को प्रासंगिकता के आधार पर रीरैंक करें। 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"
}

Library

The library is where all generated content lives — images, videos, compositions, code documents, transcriptions, and more. Use it to list items, check async generation status, update metadata, and manage your content.

List items in your library by content type.

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

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://cdn.zubnet.com/files/abc123.mp4",
        "size": 8421376,
        "extension": "mp4"
      },
      "created_at": "2026-03-01T12:00:00Z"
    },
    ...
  ]
}

Get a single library item by ID. This is the primary endpoint for polling async generation status.

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

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

# 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!)

Update a library item's metadata.

Delete a library item and its associated files.

Get the total count of items for a content type. Supports the same query and model filters as the list endpoint.

असिस्टेंट्स

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

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

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

Update an assistant's configuration (name, model, system prompt, settings).

Delete an assistant.

MCP Store

MCP (Model Context Protocol) सर्वर ब्राउज़ करें और एक्टिवेट करें to give your agents extended tool capabilities — from web search and data access to code execution and third-party integrations.

Browse the MCP server catalog.

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

Activate an MCP server for your workspace. Provide configuration values (API keys, etc.) as defined by the server's 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"
}

List all MCP servers activated in your workspace.

Update an activation's configuration or status.

Deactivate an MCP server from your workspace.

Agents

ऑटोनोमस 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-4-20250514",
    "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-4-20250514",
  "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://cdn.zubnet.com/files/avatar.jpg"
  },
  "channels": []
}

List all agents in the workspace. Supports pagination and filtering.

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

Get full details of a specific agent, including its channels, linked MCP servers, and knowledge bases.

Update an agent. All fields are optional — only provided fields are changed.

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

अनुमतियाँ ऑब्जेक्ट

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

Delete an agent. This also removes all its channels, triggers, messages, and integrations.

इंटीग्रेशन

Link a knowledge base to an agent for RAG-powered responses. Body: { "knowledge_base_id": "uuid" }

Unlink a knowledge base from an agent.

Link an MCP server to an agent for extended tool use. Body: { "activation_id": "uuid" }

Unlink an MCP server from an agent.

Retrieve conversation history for an agent.

{
  "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-4-20250514",
      "created_at": 1709222401
    }
  ]
}

एजेंट चैनल्स

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

Add a communication channel to an agent.

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

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

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
}

List all channels connected to an agent.

Remove a channel from an agent.

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

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

Create an automated trigger for an agent.

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

Example: Daily Summary Trigger

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
}

List all triggers for an agent.

Update a trigger. All fields are optional. Set status to 0 to disable or 1 to enable.

Delete a trigger.

वर्कस्पेस

वर्कस्पेस आपकी टीम की संगठनात्मक इकाई है। 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"
}

Update a workspace's settings. Requires workspace manage permission.

वर्कस्पेस हटाएँ। वर्कस्पेस मैनेज परमिशन ज़रूरी है।

Invite a user to join the workspace by email. Maximum 20 pending invitations per workspace.

Cancel a pending invitation.

Remove a member from the workspace, or leave the workspace by using your own user ID.

List aggregated usage statistics for the workspace. Supports cursor-based pagination.

List itemized usage entries (completed library items with cost > 0). Each entry includes type, model, title, cost, and timestamp.

Get the total count of usage items.

बातचीत

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

Create a new conversation. Returns the conversation object with an empty message list.

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

Send a message to a conversation and receive an AI response via Server-Sent Events (SSE). See the चैट कम्प्लीशन section for SSE event format details.

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

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

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

Account

अपनी यूज़र प्रोफ़ाइल प्रबंधित करें और प्रोग्रामेटिक रूप से API कीज़ जनरेट करें।

Update your profile information.

Generate a new API key. Requires password confirmation for security. The full API key is returned only once in this response — store it securely.

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

Billing

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

List available subscription plans.

List orders for the current workspace. Supports cursor-based pagination.

Start a checkout for a subscription plan or credit purchase. Requires workspace manage permission.

Cancel the current workspace subscription. Requires workspace manage permission.

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

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

Submit a content report. Each user can only report a given item once.

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

Errors

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

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

रेट लिमिट

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

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