Dokumentasi API

Pendahuluan

Zubnet API memberi Anda akses terprogram ke 408 model AI untuk pembuatan teks, gambar, video, musik, suara, dan kode. Sepenuhnya kompatibel dengan spesifikasi API OpenAI — jika Anda sudah menggunakan OpenAI, beralihlah ke Zubnet dengan mengganti URL dasar dan kunci API.

URL Dasar

https://api.zubnet.com/v1

Mulai Cepat

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

Otentikasi

Semua permintaan API memerlukan autentikasi melalui token Bearer pada header Authorization.

Authorization: Bearer YOUR_API_KEY

Anda dapat membuat kunci API dari pengaturan akun. Jaga keamanan kunci Anda — kunci tersebut memberikan akses penuh ke akun Anda.

Menggunakan Kunci Penyedia Anda Sendiri (BYOK)

Anda dapat menggunakan kunci API sendiri dari penyedia yang didukung. Tambahkan kunci tersebut di pengaturan ruang kerja agar digunakan otomatis untuk permintaan ke penyedia terkait — tanpa markup biaya. BYOK tersedia pada paket yang mendukungnya.

Saat kunci BYOK dikonfigurasi untuk penyedia, kunci tersebut diprioritaskan dibandingkan kunci platform. Tidak ada perubahan yang diperlukan pada permintaan API Anda — resolusi kunci sepenuhnya transparan.

Penyedia BYOK yang didukung

Model

Tampilkan semua model yang tersedia.

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

Chat Completions

Buat chat completion. Ini adalah endpoint utama untuk pembuatan teks dan kompatibel dengan format chat completions OpenAI.

Isi Permintaan

Contoh Permintaan

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

Pembuatan Kode

Buat kode dari prompt bahasa alami. Respons dikirim secara streaming melalui Server-Sent Events (SSE).

Isi Permintaan

Contoh Permintaan

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): ..."
}

Pembuatan Gambar

Buat gambar dari prompt teks menggunakan model FLUX, Stable Diffusion, Ideogram, dan lainnya.

Model yang Tersedia

Isi Permintaan

Contoh Permintaan

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

Pembuatan Video

Buat video dari prompt teks atau gambar. Mendukung alur kerja text-to-video, image-to-video, dan video-to-video.

Model yang Tersedia

Isi Permintaan

Contoh: Teks-ke-Video

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

Contoh: Gambar-ke-Video

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

Pemahaman Video

Analisis konten video dengan AI. Kirim URL video untuk dianalisis, lalu lakukan polling untuk mengambil hasilnya. Mendukung beberapa jenis analisis.

Kirim video untuk dianalisis AI. Respons mengembalikan ID tugas yang dapat digunakan untuk melakukan polling hasil.

Isi Permintaan

Contoh Permintaan

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

Periksa status pekerjaan analisis video.

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

Komposisi Musik

Hasilkan musik asli dari deskripsi teks, lirik, atau tag gaya.

Model yang Tersedia

Isi Permintaan

Contoh Permintaan

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

Efek Suara

Hasilkan efek suara dari deskripsi teks.

Isi Permintaan

Contoh Permintaan

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

Teks-ke-Ucapan

Konversikan teks menjadi audio ucapan yang terdengar alami menggunakan suara dari ElevenLabs, Cartesia, Speechify, dan banyak lagi.

Contoh Permintaan

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

Transkripsi

Transkripsikan audio ke teks.

Contoh Permintaan

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

Isolasi Suara

Ekstrak vokal bersih dari audio, hilangkan kebisingan latar belakang dan musik. Didukung oleh ElevenLabs.

Contoh Permintaan

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

Pemisahan Stem

Pisahkan audio menjadi setiap stem (vokal, drum, bas, gitar, piano, dan lainnya). Didukung oleh ElevenLabs.

Contoh Permintaan

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

Suara

Buat dan kelola suara khusus untuk pembuatan text-to-speech.

Buat suara khusus dengan mengunggah sampel audio.

Cantumkan semua suara yang tersedia di ruang kerja Anda, termasuk suara khusus yang Anda buat.

Perbarui suara khusus (nama, pengaturan).

Hapus suara khusus.

Penyematan

Buat embedding teks untuk pencarian semantik dan pencocokan kemiripan.

Contoh Permintaan

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

Basis Pengetahuan

Buat dan kelola basis pengetahuan untuk retrieval-augmented generation (RAG). Unggah dokumen (PDF, DOCX, TXT, Markdown), atau tambahkan URL web dan teks mentah, lalu gunakan sebagai sumber dalam chat completions Anda.

Buat basis pengetahuan baru.

Isi Permintaan

Contoh: Buat Basis Pengetahuan

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

Buat daftar semua basis pengetahuan di ruang kerja Anda.

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

Dapatkan detail basis pengetahuan tertentu, termasuk dokumennya.

Hapus basis pengetahuan dan semua dokumennya.

Tambahkan dokumen ke basis pengetahuan. Mendukung unggahan file, URL, dan teks mentah.

Isi Permintaan

Contoh: Masukkan File

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

Contoh: Masukkan 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"
  }'

Contoh: Masukkan Teks Mentah

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

Tampilkan semua dokumen dalam basis pengetahuan.

Hapus dokumen tertentu dari basis pengetahuan.

Baca konten teks hasil ekstraksi dari dokumen tertentu.

Pemeringkatan ulang

Urutkan ulang daftar dokumen menurut relevansinya terhadap kueri. Berguna untuk meningkatkan hasil pencarian, pipeline RAG, dan sistem rekomendasi.

Model yang Tersedia

Isi Permintaan

Contoh Permintaan

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

Perpustakaan

Perpustakaan adalah tempat semua konten yang dihasilkan berada — gambar, video, komposisi, dokumen kode, transkripsi, dan banyak lagi. Gunakan untuk membuat daftar item, memeriksa status pembuatan asinkron, memperbarui metadata, dan mengelola konten Anda.

Tampilkan item di pustaka Anda berdasarkan tipe konten.

Jenis Konten

Parameter Kueri

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

Dapatkan satu item perpustakaan berdasarkan ID. Ini adalah endpoint utama untuk melakukan polling atas status pembuatan asinkron.

Status Pembuatan

Pola Polling

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

Perbarui metadata item perpustakaan.

Hapus item perpustakaan dan file terkaitnya.

Dapatkan jumlah total item untuk suatu tipe konten. Mendukung filter query dan model yang sama seperti endpoint daftar.

Asisten

Asisten adalah preset obrolan yang dapat digunakan kembali dengan nama, model, sistem prompt, dan pengaturan khusus. Gunakan mereka untuk membuat persona AI khusus untuk berbagai tugas.

Buat asisten baru.

Buat daftar semua asisten di ruang kerja Anda.

Perbarui konfigurasi asisten (nama, model, sistem prompt, pengaturan).

Hapus asisten.

Toko MCP

Telusuri dan aktifkan server MCP (Model Context Protocol) untuk memberikan agen Anda kemampuan alat yang lebih luas — dari pencarian web dan akses data hingga eksekusi kode dan integrasi pihak ketiga.

Telusuri katalog server MCP.

Parameter Kueri

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

Aktifkan server MCP untuk ruang kerja Anda. Berikan nilai konfigurasi (kunci API dan sebagainya) sebagaimana ditentukan oleh server dalam config_schema.

Isi Permintaan

Contoh Permintaan

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

Cantumkan semua server MCP yang diaktifkan di ruang kerja Anda.

Perbarui konfigurasi atau status aktivasi.

Nonaktifkan server MCP dari ruang kerja Anda.

Agen

Membuat dan mengelola agen AI otonom yang beroperasi di seluruh saluran komunikasi. Agen dapat merespons pesan di Telegram dan Discord, dijalankan pada pemicu terjadwal, dan memanfaatkan basis pengetahuan dan server MCP untuk kemampuan yang lebih luas.

Buat agen baru.

Isi Permintaan

Contoh Permintaan

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": []
}

Daftar semua agen di ruang kerja. Mendukung penomoran halaman dan pemfilteran.

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

Dapatkan detail lengkap tentang agen tertentu, termasuk salurannya, server MCP yang tertaut, dan basis pengetahuan.

Perbarui agen. Semua bidang bersifat opsional — hanya bidang yang disediakan yang diubah.

Isi Permintaan

Objek Izin

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

Hapus agen. Tindakan ini juga menghapus semua saluran, pemicu, pesan, dan integrasinya.

Integrasi

Tautkan basis pengetahuan ke agen untuk respons berbasis RAG. Body: { "knowledge_base_id": "uuid" }

Putuskan tautan basis pengetahuan dari agen.

Tautkan server MCP ke agen untuk memperluas penggunaan tool. Body: { "activation_id": "uuid" }

Putuskan tautan server MCP dari agen.

Ambil riwayat percakapan untuk agen.

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

Saluran Agen

Hubungkan agen ke platform komunikasi. Setiap agen mendukung satu saluran per jenis (satu bot Telegram, satu bot Discord).

Tambahkan saluran komunikasi ke agen.

Isi Permintaan

Contoh Permintaan

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
}

Daftar semua saluran yang terhubung ke agen.

Hapus saluran dari agen.

Agen Pemicu

Otomatiskan tindakan agen dengan pemicu. Pemicu terjadwal memakai ekspresi cron untuk berjalan pada waktu tertentu; pemicu peristiwa dijalankan sebagai respons terhadap peristiwa eksternal.

Buat pemicu otomatis untuk agen.

Isi Permintaan

Contoh: Pemicu Ringkasan Harian

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
}

Cantumkan semua pemicu untuk agen.

Perbarui pemicu. Semua bidang bersifat opsional. Tetapkan status ke 0 untuk menonaktifkan atau 1 untuk mengaktifkan.

Hapus pemicu.

Ruang kerja

Ruang kerja adalah unit organisasi untuk tim Anda. Setiap ruang kerja memiliki saldo kredit, langganan, kunci API, dan anggotanya sendiri. Kelola ruang kerja, undang anggota tim, dan lacak penggunaan.

Buat ruang kerja baru.

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

Perbarui pengaturan ruang kerja. Memerlukan izin pengelolaan ruang kerja.

Hapus ruang kerja. Memerlukan izin pengelolaan ruang kerja.

Undang pengguna untuk bergabung dengan ruang kerja melalui email. Maksimal 20 undangan tertunda per ruang kerja.

Batalkan undangan yang tertunda.

Hapus anggota dari ruang kerja, atau tinggalkan ruang kerja dengan menggunakan ID pengguna Anda sendiri.

Cantumkan statistik penggunaan gabungan untuk ruang kerja. Mendukung penomoran halaman berbasis kursor.

Tampilkan rincian entri penggunaan (item pustaka yang selesai dengan biaya > 0). Setiap entri mencakup jenis, model, judul, biaya, dan stempel waktu.

Dapatkan jumlah total item penggunaan.

Percakapan

Percakapan mengelompokkan pesan obrolan ke dalam sesi. Buat percakapan terlebih dahulu, lalu kirim pesan ke sana. Percakapan juga dapat dikelola melalui API Perpustakaan dengan tipe konten conversations.

Buat percakapan baru. Mengembalikan objek percakapan dengan daftar pesan kosong.

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

Kirim pesan ke percakapan dan terima respons AI melalui Server-Sent Events (SSE). Lihat bagian Chat Completions untuk detail format event SSE.

Isi Permintaan

Contoh Permintaan

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

Akun

Kelola profil pengguna Anda dan buat kunci API secara terprogram.

Perbarui informasi profil Anda.

Buat kunci API baru. Konfirmasi kata sandi diperlukan demi keamanan. Kunci API lengkap ditampilkan satu kali dalam respons ini — simpan dengan aman.

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

Penagihan

Jelajahi paket yang tersedia, lihat riwayat pesanan, mulai pembayaran, dan kelola langganan.

Buat daftar paket berlangganan yang tersedia.

Buat daftar pesanan untuk ruang kerja saat ini. Mendukung penomoran halaman berbasis kursor.

Mulai pembayaran untuk paket berlangganan atau pembelian kredit. Memerlukan izin pengelolaan ruang kerja.

Batalkan langganan ruang kerja saat ini. Memerlukan izin pengelolaan ruang kerja.

Laporan Konten

Laporkan konten yang tidak pantas atau melanggar kebijakan di perpustakaan umum.

Kirimkan laporan konten. Setiap pengguna hanya dapat melaporkan item tertentu satu kali.

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

Endpoint Lainnya

Cakupan API lengkap lebih luas daripada bagian di atas. Endpoint berikut sudah aktif dan menggunakan autentikasi yang sama:

Kesalahan

API menggunakan kode status HTTP standar dan mengembalikan pesan kesalahan terperinci.

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

Batas Laju

Batas permintaan berbeda menurut paket. Header disertakan dalam setiap respons:

Jika mencapai batas permintaan, tunggu hingga waktu reset atau hubungi kami untuk menaikkan batas Anda.