Memilih Integrasi
Pilih V1 Open API, Skills, atau MCP berdasarkan skenario penggunaan Anda
Mangogo.ai menyediakan beberapa jalur integrasi. Pilih opsi yang paling sesuai dengan skenario Anda.
1. Membandingkan tiga opsi
| Dimensi | V1 Open API | Skills | Layanan MCP |
|---|---|---|---|
| Path | /v1/* | Instal paket mangogo-ai-skills | /mcp |
| Auth | Bearer Token | Variabel lingkungan MANGOGO_API_KEY | Bearer Token |
| Pengguna tipikal | Aplikasi pihak ketiga, SDK | Claude, Cursor, Codex, OpenClaw, dll. | Agent yang mendukung MCP |
| Obrolan teks | ✅ 3 endpoint | ❌ | ❌ |
| Generasi gambar | ✅ | ✅ Teks-ke-gambar | ✅ |
| Generasi video | ✅ termasuk mangogo.ai | ✅ termasuk mangogo.ai multimodal | ✅ Standar + polling |
| Unduh video | ✅ content | ✅ Unduh otomatis | ❌ (URL) |
| TTS | ✅ Biner | ✅ Simpan file lokal | ✅ (URL) |
| Streaming SSE | ✅ Endpoint teks | ❌ | ❌ |
Ringkasan:
- Butuh integrasi SDK, endpoint teks, mangogo.ai multimodal, atau unduhan biner langsung → gunakan V1 Open API
- Butuh menghasilkan gambar/video/audio di dalam percakapan Agent → gunakan Skills (instal
mangogo-ai-skills) - Butuh akses protokol MCP (konfigurasi
/mcptanpa menginstal paket skill) → gunakan Layanan MCP
2. Memilih kemampuan V1 API
Teks: endpoint mana dari tiga opsi?
| Endpoint | Gunakan saat |
|---|---|
POST /v1/chat/completions | Obrolan umum, tool calling, input multimodal, streaming SSE |
POST /v1/completions | Penyelesaian teks legacy (prompt → kelanjutan) |
POST /v1/responses | Responses multi-putaran, reasoning, output terstruktur, tool calling |
Sebagian besar proyek baru sebaiknya memilih Chat Completions.
Lihat API Teks.
Video: path pembuatan mana?
| Endpoint | Gunakan saat |
|---|---|
POST /v1/videos | Pembuatan video standar (sora, dll.), JSON atau multipart |
POST /v1/multi/videos | Video multimodal: mode + assets[] (frame pertama, gambar referensi, perpanjangan, dll.) |
Kueri dan unduhan selalu menggunakan GET /v1/videos/{task_id} dan GET /v1/videos/{task_id}/content.
Lihat API Video.
Audio: urutan panggilan yang disarankan
GET /v1/audio/voice/{model}— daftar suara yang tersediaPOST /v1/audio/speech— sintesis menggunakandata[].codesebagai parametervoice
Lihat API Audio.
3. Matriks kemampuan Skills / MCP vs REST
| Kemampuan | REST | Skills (mangogo-ai-skills) | Tool MCP | Catatan |
|---|---|---|---|---|
| Daftar model | ✅ | ✅ | list_models | — |
| Teks-ke-gambar | ✅ | ✅ | generate_image | — |
| Edit gambar | ✅ | ❌ | edit_image | Hanya REST / MCP |
| Video standar | ✅ | ✅ | create_video | Skills termasuk polling dan unduhan |
| Video multimodal mangogo.ai | ✅ | ✅ | ❌ | Skills mendukung 7 mode |
| Daftar suara + TTS | ✅ | ✅ | list_audio_voices / text_to_speech | — |
| Obrolan teks | ✅ | ❌ | ❌ | Native Agent atau REST |
4. Alur keputusan
Perlu integrasi ke aplikasi Anda sendiri?
├─ Ya → V1 Open API
└─ Tidak → Hasilkan gambar/video/audio di dalam percakapan Agent?
├─ Ya → Instal paket Skills (mangogo-ai-skills)
│ atau konfigurasi layanan MCP (/mcp)
└─ Tidak → Pilih V1 API, Skills, atau MCP berdasarkan skenario spesifik
