API dan MCP: sambungkan Posto ke aplikasi lain

Dengan API dan MCP, anda boleh mencipta karusel daripada n8n, Zapier, sistem agensi, atau pembantu AI seperti Claude dan Cursor, tanpa membuka Posto.

Siapa yang boleh menggunakannya?

• Pelan Agency, atau pelan Starter, Pro dan Ultimate dengan tambahan API & MCP. Lihat Cara menaik taraf pelan.
• Hanya pemilik atau admin workspace boleh mengurus kunci API, dan e-mel mesti sudah disahkan.
• Ciri ini dibuka secara berperingkat. Jika halaman memaparkan API & MCP akan datang, akaun anda belum termasuk.

Cipta kunci API

1. Buka Jenama & akaun media sosial → API & MCP (/app/settings/api), kemudian klik Cipta kunci API.
2. Isi Nama kunci (cth. "n8n produksi") dan pilih Kebenaran yang perlu sahaja: Baca (lihat karusel, jadual, baki Kredit AI), Cipta kandungan (menggunakan Kredit AI), dan Jadual (jadual siaran dan webhook).
3. Klik Cipta kunci, kemudian Salin kunci dan simpan di tempat yang selamat. Kunci hanya dipaparkan sekali; selepas Sudah saya simpan, kunci tidak boleh dilihat lagi.

Kunci terdedah atau tidak digunakan? Klik Batalkan: program yang menggunakannya serta-merta hilang akses. Maksimum 20 kunci aktif bagi setiap workspace. Setiap panggilan direkodkan dalam Sejarah panggilan (kandungan permintaan tidak disimpan).

Memanggil API

Base URL: https://posto.id/api/v1. Hantar kunci dalam pengepala Authorization: Bearer <key>. Pengepala Idempotency-Key wajib untuk POST /carousels, POST /carousels/{id}/images dan POST /batches: permintaan yang diulang dengan kunci yang sama tidak mencipta kandungan atau memotong Kredit AI dua kali.

curl -X POST https://posto.id/api/v1/carousels \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: blog-1203" \
  -H "Content-Type: application/json" \
  -d '{"source":{"type":"link","value":"https://contoh.id/blog/1203"},"slides":5,"ratio":"4:5","lang":"id","images":true}'

Respons 202 mengandungi id karusel berstatus queued. Semak dengan GET /api/v1/carousels/{id} sehingga ready, atau pasang webhook carousel.ready.

• Had bagi setiap kunci: 60 permintaan seminit dan 10 penjanaan serentak. Melebihi had → 429 dengan pengepala Retry-After.
• Kredit AI sama seperti dalam aplikasi: kadar bagi setiap tindakan AI ditetapkan oleh Posto (lalai 1 Kredit AI setiap slaid, imej AI Standard 10, High 30), dipotong sebelum AI berjalan dan dipulangkan jika gagal. Siaran, jadual dan eksport tidak menggunakan Kredit AI. Lihat Cara Kredit AI berfungsi.
• Semua endpoint berserta contoh cURL, Node dan n8n ada dalam Dokumentasi API.
• Video Reels dan jadual berulang juga boleh dibuat melalui API dan MCP. Lihat Reels dan jadual berulang melalui API & MCP.

Sambungkan pembantu AI (MCP)

Pelayan MCP Posto berada di https://posto.id/mcp dan menggunakan kunci API yang sama.

1. Dalam Jenama & akaun media sosial → API & MCP, bahagian Sambungkan pembantu AI (MCP), pilih tab Claude Desktop, Cursor, Claude Code atau Aplikasi lain.
2. Klik Salin. Jika kunci baru sahaja dicipta, konfigurasi sudah mengandungi kunci anda; jika tidak, gantikan pk_live_XXXXXXXXXXXXXXXX dengan kunci anda.
3. Claude Desktop: tampal dalam claude_desktop_config.json, kemudian mulakan semula Claude Desktop. Cursor: tampal dalam .cursor/mcp.json dalam folder projek anda. Claude Code: jalankan arahan itu di terminal.

Konfigurasi Claude Desktop dan Cursor:

{
  "mcpServers": {
    "posto": {
      "type": "streamable-http",
      "url": "https://posto.id/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

Tab Aplikasi lain untuk aplikasi yang belum menyokong Streamable HTTP (memerlukan Node.js):

{
  "mcpServers": {
    "posto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://posto.id/mcp",
        "--header",
        "Authorization:${POSTO_AUTH_HEADER}"
      ],
      "env": {
        "POSTO_AUTH_HEADER": "Bearer pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

Peraturan semasa menggunakan MCP:

• Tindakan yang menggunakan Kredit AI meminta kelulusan anda dahulu: karusel melebihi 5 Kredit AI, imej AI (lalai Standard 10, High 30 Kredit AI) dan menjalankan kelompok. Pembantu memaparkan jumlah Kredit AI sebelum meneruskan. Tindakan teks AI (cth. tulis semula slaid) juga menggunakan Kredit AI.
• Jika Kredit AI tidak mencukupi untuk slaid berserta foto AI, karusel dicipta tanpa foto AI (tetap kemas), kecuali pembantu meminta foto secara jelas; permintaan itu ditolak dengan mesej Kredit AI tidak mencukupi.
• Satu sesi MCP kini dihadkan kepada 500 Kredit AI sejam (ditetapkan oleh Posto, berasingan daripada had harian workspace). Jika had dicapai, tunggu jam seterusnya.

Masih keliru? Hubungi [email protected].