Memilih Integrasi
Pilih V1 Open API, Skills, atau MCP berdasarkan skenario penggunaan Anda
YunSell 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 yunsell-ai-skills | /mcp |
| Auth | Bearer Token | Variabel lingkungan YUNSELL_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 yunsell | ✅ termasuk yunsell 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, yunsell multimodal, atau unduhan biner langsung → gunakan V1 Open API
- Butuh menghasilkan gambar/video/audio di dalam percakapan Agent → gunakan Skills (instal
yunsell-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 (yunsell-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 yunsell | ✅ | ✅ | ❌ | 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 (yunsell-ai-skills)
│ atau konfigurasi layanan MCP (/mcp)
└─ Tidak → Pilih V1 API, Skills, atau MCP berdasarkan skenario spesifik